UMP (Unified Media Platform)

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop)

 

 

Besides the OSD, the UMP devices offer a fully functional Linux desktop, which is referred to as the Desktop Mode. Using the Desktop Mode is quite similar to using most common desktop environments such as Finder on Apple’s Mac OS, Explorer for Microsoft Windows or the CDE on Sun Solaris.

 

Navigation is performed mainly by means of the mouse (UMP-R-2XX, UMP-R-3XX or UMP-1-XX with Mouse Mode enabled), although a large number of functions can be utilized by the keyboard (UMP-R-2XX, UMP-R-3XX). The remote control commands for the various remote control types are listed in this manual under chapter 1, section 4.

 

 

Advanced OSD functions

 

Both the OSD and the desktop share the property of sorting files in an easy and customizable fashion. The File Manager used in the Desktop Mode is discussed in section 9 of this chapter. In the OSD you can customize any directory to look and behave as desired by creating an FXD file for it with the required parameters. This can be done manually or from within the OSD by highlighting a directory and selecting Configure Directory from the Item Menu or by pressing the corresponding color button indicated in the IdleBar on the remote control (UMP-R-1XX, UMP-R-3XX). A menu will appear allowing you to customize various properties of the directory by setting predefined parameters to certain preset values. A list of these parameters and their functionality is presented below:

 

 

Sort by Date:

This parameter sorts the items by the file date.

Directly Autoplay Single Item

This parameter forces Autoplay if the directory only contains one item.

Force Skin Layout

This parameter forces the usage of the Skin’s layout instead of the information in any related FXD files

Directory Smart Sort

This parameter attempts to sort media in a chronological way instead of a pure alphabetic listing by recognizing incrementing numbers.

 


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Below is a continuation of the listing of directory configuration parameters mentioned on the previous page:

 

 

Directory Smart Names

This parameter provides intelligent naming for multiple items in a series of files.

Use MediaID Tag Names

This parameter forces the usage of the tag information in media files (if present).

Directory Reverse Sort

This parameter allows reverse listings regardless of criteria.

Directory Create Playlist

This parameter forces the creation of a Playlist when the directory is accessed if set to On.

Directory Add Playlist Files

This parameter provides the option whether to add Playlist files in a directory to the directory Playlist.

Directory Add Random Playlist

This parameter allows you to determine whether generated playlists should be random.

Directory Autoplay Items

This parameter forces Autoplay if the directory only contains more than one item.

Directory Autobuild Thumbnails

This parameter forces the OSD to automatically create thumbnails for video items in the specified directory.

Show all kinds of items

This parameter forces the OSD to display all (non-hidden) files in the specified directory.

 

 

Any one of these values can be set to On, Off or Auto by pressing the Enter button repeatedly. The settings are saved automatically as soon as a parameter is changed so you can return to the normal view simply by pressing Exit.

 

To reset the options, you can either set them all to Auto except the last parameter, Show all kinds of items, which should be set to Off or delete the ‘folder.fxd’ file inside the directory. It is recommended to restart the OSD to let the changes take affect.

 

 

Status

 

The Status entry in the Main Menu is provided by the ‘remind’ plugin, though it is only configured for status monitoring by default. You can enable or disable it by configuring the remind plugin in the Web Interface under Plugins -> Global.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Below is an overview of the items that are configured by default in the Status menu of the OSD. Most of the items use standard Linux system utilities to retrieve the information which are listed at the end of the description, if applicable.

 

 

Available Space

This item shows statistics regarding the used and free space on the device’s HDD and connected storage devices(df).

Interfaces

This item shows detailed information about the Ethernet interface of the device (ifconfig).

Routing Table

This item shows the full IPv4 routing table for the device (route).

USB Mounts

This item shows all connected USB devices with their VID strings and any mounted USB storage (mount).

Samba Mounts

This item shows all mounted Samba and CIFS shares (mount).

NFS Mounts

This item shows all mounted NFS shares (mount).

NFS Server Status

This item shows the NFS server status and connected hosts.

FTP Server Status

This item shows whether the FTP Server is currently running (pidof).

UPnP Services

This item shows the UPnP Server and Client status (pidof).

Torrent Client Status

This item shows the Torrent Client’s status (pidof).

Media Processes

This item shows any running instances of MPlayer or MEncoder that may be running in the background.

Hardware Sensors

This item displays the full output from the device’s integrated system sensors including voltages, temperatures and fan speeds (sensors).

CPU Info

This item displays detailed information about the CPU in the device (/proc/cpuinfo).

RAM Info

This item displays detailed information about the RAM in the device and its usage (/proc/meminfo).

About this UMP

This item opens the Device Info that can also be accessed in the Web Interface.

 

IdleBar

 

The IdleBar is an integral part of the OSD, though it can be disabled, though this is not advised as it provides information about the system’s current status, weather information, music playing, backups or recordings as well as displaying the time.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

IdleBar

 

The IdleBar can be configured by means of a number of plugins which are listed under Plugins -> Idlebar in the Web Interface.

 

Below is a list of the IdleBar plugins and their individual function:

 

Idlebar

This plugin provides the IdleBar in the OSD. If you disable it, the IdleBar is removed. It is strongly recommended to keep this plugin enabled.

idlebar.cdstatus

This plugin indicates the status of the optical drive (if installed) in the IdleBar. When a disc is inserted its icon changes to a ‘normal CD’ image instead of a transparent one.

idlebar.MultiMail.MultiMail

This is the main IdleBar mail plugin. It does not need to be activated seperately. The usage of the mail plugin constitutes a SECURITY RISK due to the fact that the password must be entered in plaintext and will be visible in the Web Interface. For this reason, the plugin and its related plugins (MultiMail.Imap and MultiMail.Pop3) cannot be enabled via the Web Interface. See the notes at the end of this section for more information.

idlebar.MultiMail.Imap

This is the IdleBar IMAP plugin, which lists the number of unread messages in the specified mailbox. See the notes at the end of this section for more information.

idlebar.MultiMail.Pop3

This is the IdleBar POP3 plugin, which lists the number of unread messages in the specified mailbox. See the notes at the end of this section for more information.

idlebar.clock

This plugin provides the time and date display in the IdleBar. It is generally recommended to keep this plugin enabled.

idlebar.diskfree

This plugin provides information regarding the available space on the device’s HDD in the IdleBar. It changes color from green to red when the available space drops under a specified amount.

idlebar.holidays

This plugin displays icons in the IdleBar on the specified holidays. It can be used for any date, though.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Below is the continuation of the list of the IdleBar plugins and their individual function mentioned on the previous page:

 

idlebar.system.procstats

This plugin provides CPU and RAM information in the IdleBar. It is recommended to keep this plugin enabled so that you can monitor the system’s status.

idlebar.system.sensors

This plugin displays information from the system’s sensors in the IdleBar, such as CPU and SYS temperatures.

idlebar.tv

This plugin provides the TV logo in the IdleBar which indicates whether the EPG has expired, or whether a recording is currently in progress.

idlebar.volume

This plugin provides the audio icon in the IdleBar which displays an indication of the volume in the form of a volume bar or a red cross through the speaker, indicating that the sound is muted.

idlebar.weather

This plugin retrieves and displays the current weather type and temperature for a specified location, based on the information from http://www.weather.com/.

idlebar.logo

This plugin displays the UMP logo in the IdleBar. Note that this can fill a considerable amount of space when using lower resolutions, and it may interfere with the ‘audio.detach’ plugin if there is not enough space.

idlebar.progactive

This plugin allows you to monitor a certain process. It can be used to indicate whether an encoding job is running, or whether there are any network shares connected. See the plugin’s description for some usage examples.

 

The IdleBar plugins can be activated or removed in the Web Interface under Plugins -> Idlebar, with the exception of the idlebar.MultiMail plugins.

Due to the inherent security risk involved with keeping the password saved in plain text, it is not recommended to enable these plugins.

 

 

If you wish to enable this plugin, you will need to edit the OSD configuration file manually with the Text Editor in the Desktop Mode and adding the ‘plugin.activate’ statement to the configuration in ‘/etc/freevo/local_conf.py’. Note that editing the configuration by hand is only recommended for advanced users and may void the software warranty on the device.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Desktop Mode

 

One of the main advantages of using the Desktop Mode is the fact that multitasking can be achieved with any combination of applications provided they do not keep focus or use fullscreen mode(s). You can use <Alt>+<Tab> to switch between windows, and the window selection dialog will remain open while you keep the <Alt> key pressed. Press <Tab> repeatedly until the desired window is highlighted and release the <Alt> key again.

 

Mouse Mode

 

Note that you can use the Mouse Mode of the remote control UMP-R-1XX together with both the UMP-R-2XX and UMP-3-XXX. If simultaneous input is received from multiple input devices, the first-in-first-out (FIFO) principal is applied, though true HID devices (USB or PS/2) generally take precedence.

 

When using the Mouse Mode with the remote control UMP-R-1XX, you can move up, down, left and right in smaller increments by using the ‘combined directional keys’, as explained in the following example. If you need to navigate to a certain text input field or control, you may find that the cursor ‘jumps’ over the field. An example is the URL entry field in the Web Browser. If the cursor is positioned beneath the bar, pressing the ‘2’ button may move the cursor to a position above the bar. To avoid this you can use a combined directional key such as ‘1’ or ‘3’ as they also move upwards. The same applies for other directions with the corresponding keys. In the Mouse Mode you can change desktop with the Vol+ and Vol- controls.


Note that the Mouse mode is not disabled automatically when starting the OSD from the Desktop Mode, and it can interfere with media playback.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Icons

 

In the Desktop Mode, you will see three icons placed near the left hand border of the screen. These icons represent the main tasks in the Desktop Mode, the applications are listed elsewhere. Here is an overview of their functions:

 

-         UMP-OSD – This starts the UMP-OSD in fullscreen mode. Note that the OSD will be restarted if it was still active in the background. This function is mapped to the Start/Stop OSD button on the remote control (UMP-R-1XX).

 

-         Keyboard – This opens the V-Keyboard in windowed mode. Note that you cannot properly operate the application with only a keyboard (UMP-R-3XX without the mouse). This function is mapped to the V-Keyboard button on the remote control (UMP-R-1XX).

 

-         Help – This opens the user manual on the device in the PDF Reader, windowed. This is not the same as the Help button on the UMP-R-1XX remote control which is only responsible for the integrated OSD Help.

 

 

Menus

 

The desktop interface offers syntax and application menus, which Microsoft Windows or Gnome/KDE users will find quite self explanatory. Menus which are opened by means of the right mouse button (UMP-R-2XX, UMP-R-3XX) or Prev button (UMP-R-1XX with Mouse Mode enabled) are referred to as syntax menus. Individual syntax menus may have special names used by Openbox, the window manager that handles most of the Desktop Mode interaction. When you perform a right click on a TitleBar of a window, the Client Menu is displayed.

The Client Menu is a multifunctional menu listing possible actions for the selected window or application. The items commonly listed are explained below:

 

-         Send to Desktop -> - This option opens a submenu with the available desktops. By default, two desktops are configured.

-         Layer -> - This open opens a submenu with the following options:

-         Always on Top – This sets the window to always retain focus.

-         Normal – This sets the window (back) to the default behavior

-         Always on Bottom – This sets the window never to have focus when other windows overlap.

 

 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Here is the continuation of the Menu overview from the previous page.

 

-         Restore – This option sets the window (back) to the windowed mode from the maximized state

-         Move – This option allows you to move the window with the mouse (or numeric controls on the UMP-R-1XX). To accept the window’s (new) position, press the left mouse button (or Mute on the UMP-R-1XX).

-         Resize – This option allows you to alter the size of the window with the mouse (or numeric controls on the UMP-R-1XX).

-         Iconify – This option hides the current window. It can only be reactivated by itself, the key combination <Alt>+<Tab> or by launching the task again, though this only works if the particular application does not allow multiple instances. It is not recommended to Iconify windows when only using the UMP-R-1XX.

-         Maximize – This stretches the current window to cover the entire visible desktop. You can use the Restore function mentioned above to restore its size again.

-         Roll Up/Down – This option allows you to reduce the size of a window to its Title Menu. This hides the window, but the TitleBar remains visible, allowing for quick access to it again. This function is the recommended way to quickly hide windows with the UMP-R-1XX.

-         Undecorate – This option can be used to remove the Title Menu and window borders that the Desktop Mode adds to windows. Note that this does not work for all applications, and is a purely cosmetic feature.

-         Close – This option closes the current window or exits the application.

 

 

QuickMenu

 

As well as the syntax menus, the main menu in the Desktop Mode can be opened by right clicking on the desktop itself, and is referred to as the QuickMenu. A detailed overview of the individual QuickMenu functions is presented on the following page.

 

Menus are printed in ‘Bold Italic’, Headers in ‘Bold’ and menu items as ‘regular text’.

 

 


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Here is the overview of the QuickMenu items mentioned on the previous page.

 

Applications

Editors ->

 

This opens a list of the Editors Menu.

Editors -> Text Editor

This opens the Text Editor, which is described later in this section.

Applications ->

This opens the Applications Menu.

 

Applications -> Browse the Web

This opens the Web Browser, which is described later in this section.

Applications -> Chat/IM Client

This opens the InstantBird, the Chat Client, which is described later in this section.

Applications -> PDF Reader

This opens xPDF, the PDF Reader, which is described later in this section.

Multimedia ->

 

This opens the Multimedia Menu.

Multimedia -> TvTime

This opens TvTime, an application for watching TV, which is described later in this section.

Multimedia -> MPlayer

This opens MPlayer, which is described later in this section.

Games ->

This opens the Games Menu

Games -> Super NES Emulator

This opens zSNES, the SNES emulator, which is described in chapter 10 of this manual.

Games -> Playstation 1 Emulator

This opens psX, the Playstation emulator, which is described in chapter 10 of this manual.

Games -> DOSbox (DOS Emulator)

This opens DOSbox, a DOS emulator, which is described in chapter 10 of this manual.

System ->

 

This opens the System Menu

System -> Adjust Gamma Settings

This opens the Gamma utility, which is described later in this section.

System -> Set Screen Resolution

This opens the UMP ResTool, which is described later in this section.

System -> Mouse Settings

This opens the Mouse Settings dialog, which is described later in this section.

System -> Network Shares

This opens the UMP Samba Client, which is described later in this section.

System -> File Manager

This opens the File Manager, which is described later in this section.


 

12.1 Advanced Navigation and Mouse Mode (OSD/Desktop) (continued)

 

Here is the continuation of the QuickMenu overview from the previous page.

 

 

System -> OnScreen Keyboard

This opens the V-Keyboard, which is described later in this section.

System -> Eject Optical Drive

This attempts to eject the optical drive (if present).

UMP/OSD

Return to UMP-OSD

This starts the UMP-OSD. Note that the OSD will be restarted if it was active in the background.

UMP/OSD ->

 

This opens the UMP/OSD Menu

UMP/OSD -> Return to UMP-OSD

This starts the UMP-OSD. Note that the OSD will be restarted if it was active in the background.

UMP/OSD -> Rebuild UMP/OS Cache

This option rebuilds the OSD Media Cache entirely. It is recommended to stop the OSD before running this, although it should not affect stability.

UMP/OSD -> Restart the UMP

This option restarts the UMP device without confirmation.

UMP/OSD -> Shutdown UMP (no wakeup)

This option shuts the UMP device down without confirmation or scheduled wakeup.

 

 

To select an option in the QuickMenu, highlight it by using the direction keys (UMP-R-2XX, UMP-R-3XX) or by moving the cursor (UMP-R-1XX with Mouse Mode enabled, UMP-R-2XX or UMP-R-3XX) and press the left mouse button or Enter on the keyboard or remote control.

 

The QuickMenu is also tied to the <Ctrl>+<Esc> controls on the keyboard (UMP-R-3XX). On the UMP-R-1XX you can use the asterisk “*” button underneath the numeric keys.

12.10 Using the IM Client

 

One of the many aspects that make the UMP devices so unique is their flexibility, allowing you to enjoy media with a remote control, or browse the web and write documents using a mouse and keyboard. The IM Client is a logical extension of the web browsing functionality.

 

Note that the IM Client requires a mouse and keyboard to be operated correctly (UMP-R-3XX) though the mouse is optional.

 

To open the IM Client, select IM Client (Desktop Mode) from the Commands Menu in the OSD or open the QuickMenu in the Desktop Mode and select it from the Applications menu.

 

The IM Client allows you to set up multiple identities in one single application, effectively providing the advantages of a single sign-on system. Currently, the following networks/protocols are support by the client:

 

 

AIM/ AOL

AOL Instant Messenger

Gadu-Gadu

The Gadu-Gadu network

GoogleTalk

Google’s XMPP implementation

ICQ

The ICQ network

 IRC

Internet Relay Chat

Jabber/XMPP

Extendable Messaging and Presence Platform

MSN

Microsoft Network

QQ

The Qq network

Yahoo

Yahoo instant messaging

 

 

Note: if you launched the IM Client from the OSD, you can close the application’s main window without restoring the OSD automatically on top of any child windows.

 

For more information on using the IM Client see the built-in Help function and the documentation at http://instantbird.com/support.html.

12.11 Using the PDF Reader

 

Because of the widespread usage of the Portable Document Format (PDF), a PDF reader has been integrated into the UMP. This allows you to view the user manual or almost any other PDF document.

 

This application can be operated with any of the remote control type, ranging from the UMP-R-1XX to the mouse and keyboard (UMP-R-3XX). The PDF Reader provides a sleek an unobtrusive user interface which is focused on navigation in the PDF document. If the application is launched from the OSD or the QuickMenu, no document will be loaded, and the main window’s grey background will be visible.

 

To open the PDF Reader, select PDF Reader (Desktop Mode) from the Commands Menu in the OSD or open the QuickMenu in the Desktop Mode and select it from the Applications menu.

 

To load a PDF file in the reader, simply drag it to the PDF Reader main window from an open File Manager instance, or almost any other dialog allowing you to navigate through the filesystem of the device.

 

The PDF Reader is configured as the default application for the Web Browser to open PDF documents, though this behavior can be customized in the Web Browser’s advanced configuration. See section 7 of this chapter for more information on the usage of the Web Browser.

 

To exit the PDF Reader, select the close button in its TitleBar or press the Quit button in the bottom right hand corner of the main application window.

 

For more information on using the Xpdf (the PDF Reader) see the built-in Help function and the documentation at http://www.foolabs.com/xpdf/about.html.

12.12 Using the Text Editor

 

Any modern desktop environment, such as the UMP Desktop Mode, should include a text editor. Due to the presence of the ROX utilities for the gamma settings and file management, the ROX-edit text editor has been implemented on the UMP.

 

Note that the Text Editor requires a mouse and keyboard to be operated correctly (UMP-R-3XX) though the mouse is optional.

 

To open the Text Editor open the QuickMenu in the Desktop Mode and select it from the Editors menu. The Text Editor is not listed in the Commands Menu of the OSD.

 

The main purpose of the Text Editor is the manual editing of configuration files, though you can use it for any kind of task. You can save files in your home directory (the default directory that is opened when you launch the File Manager) or the public directories (/mnt/data/).

 

For more information on using the Text Editor see the built-in Help function and the documentation at http://roscidus.com/desktop/about_rox.

12.13 Using the Mouse utility

 

If you use the UMP-R-3XX for remote control or a generic mouse and keyboard, you may need to configure the mouse acceleration and acceleration threshold to meet your personal likings or to compensate for a certain type of surface on which the mouse is being used.

The UMP MouseTool provides a simple configuration interface for these settings including the option to revert to the default Desktop Mode settings.

To launch the UMP MouseTool open the QuickMenu in the Desktop Mode and navigate to System -> Mouse Settings.

In the UMP MouseTool there are two sliders in the upper section of the application window. The left slider, labeled Acceleration, determines the effective overall speed of the mouse, or acceleration factor, and can be moved in increments of ‘1’ to a value of 1 through 10. The default value 1 is recommended for uneven or reflective surfaces. The right slider, labeled Threshold, determines the number of pixels that the cursor must travel before accelerating. The Threshold slider can be set to any value between 1 and 100, where the value ‘1’ disables the acceleration threshold and forces the mouse to retain a constant traveling speed.

Note: values higher than 100 can be used, though these must be configured manually from a Terminal. This is only recommended for advanced users and these settings will be lost if the MouseTool is launched and its settings are applied. By default the UMP MouseTools saves its configuration file in ‘$HOME/.mouse’.

The default values for the Acceleration and Threshold parameters are ‘1’.