RF remote controls: Difference between revisions
No edit summary |
No edit summary |
||
Line 10: | Line 10: | ||
# Install a keyboard testing application such as [http://www.passmark.com/products/keytest.htm KeyboardTest](Windows) or [http://www.x.org/archive/current/doc/man/man1/xev.1.xhtml Xev] (X11) such programs will report invisible keystrokes (Alt/Esc/PgUp...etc) | # Install a keyboard testing application such as [http://www.passmark.com/products/keytest.htm KeyboardTest](Windows) or [http://www.x.org/archive/current/doc/man/man1/xev.1.xhtml Xev] (X11) such programs will report invisible keystrokes (Alt/Esc/PgUp...etc) | ||
# Connect the USB dongel to the PC running the keyboard testing application (Most RF remotes are PnP) | # Connect the USB dongel to the PC running the keyboard testing application (Most RF remotes are PnP) | ||
# Press the remote keys, one by one, take notes about the keystrokes/mouse-clicks reported by the application. '''Note any modifiers''' Alt+F2 is not the same as F2 | # Press the remote's keys, one by one, take notes about the keystrokes/mouse-clicks reported by the application. '''Note any modifiers''' Alt+F2 is not the same as F2 | ||
'''Modifying KODI for your remote''' | '''Modifying KODI for your remote''' | ||
# Decide which KODI actions you wish to map to your remote buttons. | # Decide which KODI actions you wish to map to your remote buttons. |
Revision as of 08:22, 20 January 2015
Remote controls | RF remote controls |
Wiki revamp: This page or section of the wiki undergoing a revamp. Content is still being added and organized. Please pardon the dust and anything that might not be working. |
Various RF remotes that use a small USB "dongle" typically are seen as a keyboard + mouse by the computer/HTPC.
Each button on the remote sends keystroke(s) or mouse-clicks to KODI.
To link the buttons on the remote to your desired KODI actions, you will most likely need to customize your keymaps
Configuring KODI for your remote
Discovering which keystroke(s) | mouse-clicks your remote is sending
- Install a keyboard testing application such as KeyboardTest(Windows) or Xev (X11) such programs will report invisible keystrokes (Alt/Esc/PgUp...etc)
- Connect the USB dongel to the PC running the keyboard testing application (Most RF remotes are PnP)
- Press the remote's keys, one by one, take notes about the keystrokes/mouse-clicks reported by the application. Note any modifiers Alt+F2 is not the same as F2
Modifying KODI for your remote
- Decide which KODI actions you wish to map to your remote buttons.
- For keystrokes: Following the instructions in keymaps, edit the keyboard.xml file to assign your desired KODI actions to the keystrokes sent by your remote's button.
- For mouse-clicks: Following the instructions in keymaps, edit the mouse.xml file to assign your desired KODI actions to your remote's button.
Special Considerations for Mouse-Clicks (available starting in version 15)
RF remotes often have an integrated Air Mouse. Most KODI users will only wish to use the left and right button of the Air-mouse
To disable the mouse-cursor place these 2 entries in mouse.xml
- <mousemove>noop</mousemove>
- <mousedrag>noop</mousedrag>
To properly capture a left-click, you need to place 2 entries in mouse.xml
- <leftclick>Select</leftclick>
- <mousedragend>Select</mousedragend>
To properly capture a right-click, you also need to place 2 entries in mouse.xml
- <rightclick>Back</rightclick>
- <mouserdragend>Back</mouserdragend>
Other examples of such remotes include the Motorola Nyxboard Hybrid and Boxee remote.
Customizing buttons through the GUI
Users can customize keymaps for remotes in GUI by using the community Keymap Editor add-on.