Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: removed obsolete references to Generic-HID.xml and added explanations for enablind full keyboard support and dealing with key bounce


Simply tick the Enable HID option in the HID configuration panel to enable your input device.  To enable support for a full keyboard (including letters. like the illustration at top left) select "full" instead of "classic" classic from the drop-down list Profile and tick the box Use HID keyboard. Choosing full from the drop-down list without enabling HID keyboard (or vice versa) can lead to unpredictable behaviour.  For example, if full is selected from the drop-down list "Profile".(instead of the default classic) without ticking the box Enable HID keyboard, MP may act as if the keyboard suffers from "bounce", i.e. MP responds to each keystroke as if it were doubled.  For real key bounce problems, see Technical notes below.
When enabled, the Extended logging option causes each HID input to be recorded in the main MediaPortal log file. It's only necessary to enable this option when you're troubleshooting.


Repeat handling

The repeat delay and speed options enable you to customise repeat handling for gamepads and remote controls. Repeat handling for other input devices is controlled by Windows. For more information about Windows' repeat settings please refer to Microsoft online documentation.

Repeat delay defines how long a button must be held down before it starts repeating.

Repeat speed defines how quickly repeat events are generated once a button starts repeating (ie. while it is being held down). This option can influence the speed at which you scroll through a list, how quickly volume increases or decreases etc.

To use Windows repeat settings, set these options to -1 (default). Windows default repeat delay and speed are typically 500 and 33 milliseconds respectively.

Some gamepad and remote control buttons produce keyboard events. Repeat handling for those buttons is governed by Windows rather than MediaPortal. Buttons that produce keyboard events often (but not always!) include:

  • numbers/digits
  • arrows/directions
  • OK/enter

Technical notes

Experienced users can customise HID configuration by editing Generic-HID.xml.
There are up to two instances of this file on your system, the default one as installed by MP1 and the custom one which take precedence if present.
The default one will be overwritten whenever you re-install MP1.
The custom one will remain the same even after re-installing MP1, meaning that any changes to the default configuration won't take effect until applied manually.

  • Default path: C:\Program Files (x86)\Team MediaPortal\MediaPortal\defaults\InputDeviceMappings\Generic-HID.xml
  • Custom path: C:\ProgramData\Team MediaPortal\MediaPortal\InputDeviceMappings\Generic-HID.xml

Also number Number keys, backspace, ESC, dot, sharp, enter and direction arrows, even when issued from your remote, typically do not go through the HID handler. Instead they go through the classic keyboard handler. In order to customise them you need to modify your keyboard key mapping rather than your remote key mapping.

Some keyboards (typically only older mechanical keyboards) suffer from "key bounce", i.e.the OS or MP will respond to each keystroke as if the key had been pressed more than once. If your keyboard exhibits this behavior, there is a workaround:
  1. In PC Settings - Ease of access - Keyboard or Control Panel - Ease of Access center - Make the keyboard easier to use turn on Filter Keys.
  2. Start the registry editor (from the search box or by pressing the Windows key together with R and typing in "regedit").
  3. Navigate to Computer\HKEY_CURRENT_USER\Control Panel\Accessibility\Keyboard Response.
  4. Right-click on the above-named key and click Export to make a backup copy of the key, in case of problems
  5. Set the following values (in ms):

    AutoRepeatDelay = 500
    AutoRepeatRate = 50
    BounceTime = 15
    (You may need to experiment with the last value: if it is too low, it won't prevent the "phantom" keystrokes, if it is too high, it will make it difficult to type anything with repeating characters, e.g. "troop".)

  6. Restart the computer to make the new values take effect.