UMP (Unified Media Platform)

9.1 Commands Overview


Because the UMP devices are basically Linux based computers, running a media and entertainment oriented visual environment, they have been designed to uphold some of the basic advantages provided by the underlying operating system, such as avoiding the necessity to restart the entire device on a frequent basis, though energy efficient operation by means of hibernation and low power components has also been taken into account.


One of the almost unique feature of the UMP is that it allows you to execute commands on the device, not only via the Helper scripts in the Web Interface, but also under Commands in the OSD. When you open the Commands Menu, you will see a list of available commands which are explained below:


Adjust Gamma Settings

This opens the Gamma Utility in the Desktop Mode. It allows you to adjust the individual color channels up and down, adjust all 3 simultaneously or reset to the default settings.

Adjust Screen Resolution

This opens the UMP ResTool in the Desktop Mode which allows you to select a screen resolution. Please read the notes regarding the usage of this tool in chapter 12 of this manual.

Browse the Web

This opens the Web Browser in the Desktop Mode and works exactly like the Browse the Web item in the Main Menu.


This is a script which is executed in the OSD. It removes temporary and other superfluous files from the filesystem.

Connect Network Shares

This opens the UMP/OS Samba Client in the Desktop Mode, which allows you to connect SMB (Samba) network shares. Please read the notes regarding the usage of this tool in chapter 12 of this manual.

Eject CD/DVD

This command is executed in the OSD and forcefully ejects the optical drive (if present). You may need this if you manually entered a disc, or if the regular Eject function fails.

Enter a CD/DVD

This forcefully mounts an optical disc if possible. Use this if autoplay doesn’t support the disc type.


Read more: 9.1 Commands Overview

9.2 OSD Commands


Commands that are executed in the OSD itself will either return to the Commands Menu after displaying the ‘Running Command’ dialog or present a new dialog box with either one or two choices, depending on the Command. The first choice is always ‘OK’ which confirms the script was executed and returns to the Command Menu. In some cases you may see a second option, called ‘Show output’, which shows a dialog with the ‘shell output’ of the command, providing more information about the action performed and its result.


To abort a command, press the Start/Stop OSD button on the remote control (UMP-R-1XX) or select ‘stop_osd’ from the Helper scripts under Plugins in the Web Interface. You can also choose to refresh the graphical environment entirely by selected the ‘restart_gui’ helper. The OSD will be launched automatically again afterwards.


Note that if you run the ‘cache’ helper from the Web Interface, there will be no notification in the OSD to inform you of this. In some cases, if a ‘moving image’ screensaver (bouncing_ump, bouncing_ump2 and balls) is active, the OSD may be blended into the screensaver for a brief while. This is purely cosmetic, and doesn’t influence the functionality in any way. It is recommended to restart the OSD if the cache was rebuilt from the Web Interface.

9.3 Desktop Mode Commands


Commands that are executed in the Desktop Mode will hide the OSD if launched from a fullscreen session, though music playback or other functions will remain active in the background. The OSD will become visible again as soon as the application in question quits, and you will be returned to the Commands Menu. The only exception is the Web Browser. If it’s launched from the Main Menu, it will also return to the same location afterwards.


To prevent the OSD from being hidden while another application is active in the Desktop Mode, press the OSD FScreen button on the remote control (UMP-R-1XX) or the ‘z’ key on the keyboard (UMP-R-2XX, UMP-R-3XX). This will change the OSD to the windowed mode and allow other applications to be displayed beneath and on top of it. When the OSD is in the windowed mode, the TitleBar is displayed at the top of the screen, which allows you to minimize or close the OSD, too.


To resume the fullscreen operation of the OSD, press the OSD FScreen button again so that the TitleBar is removed. Please note that the OSD must be focused for the FScreen button to take effect. In other applications, this button will generally represent the character ‘z’.

9.4 Command Plugins and Settings




Although the Commands section of the OSD is mainly defined by the functionality of the underlying scripts, some customization is possible. Note that you may also need to adjust or edit the Skin to accommodate for certain changes in the OSD’s interface.



Command (default)

This is the main Command plugin, which provides the Commands Menu. Note that if you disable this plugin, the others below will not work.

command.fxdhandler (default)

This plugin allows you to specify additional actions for items in a folder.fxd XML file.

command.CommandMainMenuItem (default)

This plugin allows you to add your own commands to the Main Menu. This plugin provides the Browse the Web command in the OSD Main Menu.



You can enable, disable and sometimes also configure these plugins by accessing the Web Interface, either locally or from a networked computer, and navigating to Plugins -> Global.





The only configuration that is not performed by the plugin arguments is the default directory in which to search for command FXD XML files. This setting is listed in the Web Interface under Settings -> All -> Other:


COMMANDS_DIR = '/usr/share/freevo/fxd/commands'


It is strongly recommended that only advanced users who are comfortable using shell access change this parameter.



After changing any of these settings, you will need to restart the OSD for the settings to take effect.