Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section is only visible in expert mode.

Table of Contents
Table of Contents




Here is where you can customize the key settings for your keyboard or remote.

Keys and Sounds Settings

  • You can alter both Global actions and Windows key settings..
  • Keys can be added and deleted, customized, and have sound events associated with the key press.

Note: This section does not support the "media keys", i.e. the volume up/down, play, stop, next, previous, etc. buttons you can find on most modern keyboards. To support these keys, you need to enable the General HID Device in the Remote section.

Keys and Sounds are stored in your user data folder (e.g. ProgramData) ...\MediaPortal\keymap.xml  Before you begin making major key changes, you may wish to back up this file first!

Note: For a list of the more than 175 supported actions, see Actions.  For a list of Windows and IDs see Windows.

Remote Control Buttons

Remote control buttons are also affected by these changes. If you don’t like the remote mapping supplied with MediaPortal for your remote, you can remap your keys here.


Of course, you can also customize which keys map to specific functions using Configuration > Remote

Change Keys

When you select Keys and Sounds in the Navigation Pane on the left, this screen will display:

First, select either Global actions or Windows keys.

Global Actions

Global actions are performed independent of the currently active module in MediaPortal


Note:  Skins often provide sounds in the Skin Sounds folder.  If you select notify.wav in the Sound box, but the skin provides a notify.wav sound file, then the skin sound will play.

Windows actions

Windows actions are connected to a specific module (window).  The window ID appears in brackets after the name of the window where the key or button action is supported. The window IDs are contained in the keymap.xml file, and match the window IDs of screens or xmls used in skins. See References >  Windows. You can also find the window ID at the top of the related skin xml file in the Skins folder (e.g. mytvugide.xml <id>600</id>)


Now, select the key you wish to change, the current assignment will be displayed and can be changed the same as for Global actions above.


Have a special theme on your PC? For each key, you can browse for a particular sound event to have MediaPortal play a corresponding wave file to match.

Delete Keys or Windows

You cannot delete the main Global actions or Window Actions at the top level. The Delete key will be grayed out and unavailable.  However, you can delete specific keys or even whole window  assignments, although it is best to leave these for future use. Just select the Window or key and press the Delete key.

Add Keys or Windows

You may add a key to Global actions or to Windows . You can even add a Window to the Windows section and add keys you wish to use in that window.