User Tools
controls
Table of Contents
Controls
The controls.conf file, located in your RetroFE directory, contains the controls for your RetroFE front-end. Multiple keys can be assigned to a single action, separated by a ,.
Example:
Up = Keypad 8, Up
This will assign both the Keypad 8 (up arrow on your keypad) and the up arrow to RetroFE's Up control.
Settings for controls:
| Control | Description | Notes |
|---|---|---|
| up | Scrolls menu up (for vertical menus) | |
| down | Scrolls menu up (for vertical menus) | |
| left | Scrolls menu left (for horizontal menus) | |
| right | Scrolls menu right (for horizontal menus) | |
| pageUp | Scrolls menu back by a page | |
| pageDown | Scrolls menu forward by a page | |
| letterUp | Scrolls to the previous item in the alphabet | Available in version 0.5.158 or later |
| letterDown | Scrolls menu next item in the alphabet | Available in version 0.5.158 or later |
| collectionUp | Scrolls to the next collection and enters it | |
| collectionDown | Scrolls to the previous collection and enters it | |
| addPlaylist | Adds a game to the favorites playlist | Available in version 0.7.1 or later |
| removePlaylist | Removes a game from the favorites playlist | Available in version 0.7.1 or later |
| nextPlaylist | Switches between the full game list and the favorites playlist | Available in version 0.7.1 or later |
| cyclePlaylist | Cycles over the playlists in the cyclePlaylist list of playlists. | |
| random | Selects a random game Available in version 0.7.1 or later | |
| select | Selects the active menu item | |
| back | Leaves current menu | |
| quit | Exits the frontend |
Controllers/joysticks are supported in versions 0.6.x and later.
Gamepad/Joystick codes
| Keycode | Description |
|---|---|
| joyXButtonY | Gamepad button (X=joypad number, Y=button number) |
| joyXHatYLeftUp | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYLeft | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYLeftDown | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYUp | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYDown | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYRightUp | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYRight | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXHatYRightDown | Gamepad hat direction (X=joypad number, Y=hat number) |
| joyXAxis0+ | First POV stick, first axis positive direction (X=joypad number) |
| joyXAxis0- | First POV stick, first axis negative direction (X=joypad number) |
| joyXAxis1+ | First POV stick, second axis positive direction (X=joypad number) |
| joyXAxis1- | First POV stick, second axis negative direction (X=joypad number) |
| joyXAxis2+ | Second POV stick, first axis positive direction (X=joypad number) |
| joyXAxis2- | Second POV stick, first axis negative direction (X=joypad number) |
| joyXAxis3+ | Second POV stick, second axis positive direction (X=joypad number) |
| joyXAxis3- | Second POV stick, second axis negative direction (X=joypad number) |
If X is omitted, RetroFE will accept input from all controllers. (version 0.8.13+)
Mouse Codes
| Keycode | Description |
|---|---|
| mouseButtonleft | the left mouse button |
| mouseButtonMiddle | the middle mouse button |
| mouseButtonRight | the right mouse button |
| mouseButtonX1 | the X1 mouse button |
| mouseButtonX2 | the X2 mouse button |
Keyboard Codes
| Keycode | Description |
|---|---|
| 0 | |
| 1 | |
| 2 | |
| 3 | |
| 4 | |
| 5 | |
| 6 | |
| 7 | |
| 8 | |
| 9 | |
| A | |
| AC Back | the Back key (application control keypad) |
| AC Bookmarks | the Bookmarks key (application control keypad) |
| AC Forward | the Forward key (application control keypad) |
| AC Home | the Home key (application control keypad) |
| AC Refresh | the Refresh key (application control keypad) |
| AC Search | the Search key (application control keypad) |
| AC Stop | the Stop key (application control keypad) |
| Again | the Again key (Redo) |
| AltErase | Erase-Eaze |
| ' | |
| Application | the Application / Compose / Context Menu (Windows) key |
| AudioMute | the Mute volume key |
| AudioNext | the Next Track media key |
| AudioPlay | the Play media key |
| AudioPrev | the Previous Track media key |
| AudioStop | the Stop media key) |
| B | |
| \ | Located at the lower left of the return key on ISO keyboards and at the right end of the QWERTY row on ANSI keyboards. Produces REVERSE SOLIDUS (backslash) and VERTICAL LINE in a US layout, REVERSE SOLIDUS and VERTICAL LINE in a UK Mac layout, NUMBER SIGN and TILDE in a UK Windows layout, DOLLAR SIGN and POUND SIGN in a Swiss German layout, NUMBER SIGN and APOSTROPHE in a German layout, GRAVE ACCENT and POUND SIGN in a French Mac layout, and ASTERISK and MICRO SIGN in a French Windows layout. |
| Backspace | |
| BrightnessDown | the Brightness Down key |
| BrightnessUp | the Brightness Up key |
| C | |
| Calculator | the Calculator key |
| Cancel | |
| CapsLock | |
| Clear | |
| Clear / Again | |
| , | |
| Computer | the My Computer key |
| Copy | |
| CrSel | |
| CurrencySubUnit | the Currency Subunit key |
| CurrencyUnit | the Currency Unit key |
| Cut | |
| D | |
| DecimalSeparator | the Decimal Separator key |
| Delete | |
| DisplaySwitch | display mirroring/dual display switch, video mode switch |
| Down | the Down arrow key (navigation keypad) |
| E | |
| Eject | the Eject key |
| End | |
| = | |
| Escape | the Esc key |
| Execute | |
| ExSel | |
| F | |
| F1 | |
| F10 | |
| F11 | |
| F12 | |
| F13 | |
| F14 | |
| F15 | |
| F16 | |
| F17 | |
| F18 | |
| F19 | |
| F2 | |
| F20 | |
| F21 | |
| F22 | |
| F23 | |
| F24 | |
| F3 | |
| F4 | |
| F5 | |
| F6 | |
| F7 | |
| F8 | |
| F9 | |
| Find | |
| G | |
| ` | Located in the top left corner (on both ANSI and ISO keyboards). Produces GRAVE ACCENT and TILDE in a US Windows layout and in US and UK Mac layouts on ANSI keyboards, GRAVE ACCENT and NOT SIGN in a UK Windows layout, SECTION SIGN and PLUS-MINUS SIGN in US and UK Mac layouts on ISO keyboards, SECTION SIGN and DEGREE SIGN in a Swiss German layout (Mac: only on ISO keyboards), CIRCUMFLEX ACCENT and DEGREE SIGN in a German layout (Mac: only on ISO keyboards), SUPERSCRIPT TWO and TILDE in a French Windows layout, COMMERCIAL AT and NUMBER SIGN in a French Mac layout on ISO keyboards, and LESS-THAN SIGN and GREATER-THAN SIGN in a Swiss German, German, or French Mac layout on ANSI keyboards. |
| H | |
| Help | |
| Home | |
| I | |
| Insert | insert on PC, help on some Mac keyboards (but does send code 73, not 117) |
| J | |
| K | |
| KBDIllumDown | the Keyboard Illumination Down key |
| KBDIllumToggle | the Keyboard Illumination Toggle key |
| KBDIllumUp | the Keyboard Illumination Up key |
| Keypad 0 | the 0 key (numeric keypad) |
| Keypad 00 | the 00 key (numeric keypad) |
| Keypad 000 | the 000 key (numeric keypad) |
| Keypad 1 | the 1 key (numeric keypad) |
| Keypad 2 | the 2 key (numeric keypad) |
| Keypad 3 | the 3 key (numeric keypad) |
| Keypad 4 | the 4 key (numeric keypad) |
| Keypad 5 | the 5 key (numeric keypad) |
| Keypad 6 | the 6 key (numeric keypad) |
| Keypad 7 | the 7 key (numeric keypad) |
| Keypad 8 | the 8 key (numeric keypad) |
| Keypad 9 | the 9 key (numeric keypad) |
| Keypad A | the A key (numeric keypad) |
| Keypad & | the & key (numeric keypad) |
| Keypad @ | the @ key (numeric keypad) |
| Keypad B | the B key (numeric keypad) |
| Keypad Backspace | the Backspace key (numeric keypad) |
| Keypad Binary | the Binary key (numeric keypad) |
| Keypad C | the C key (numeric keypad) |
| Keypad Clear | the Clear key (numeric keypad) |
| Keypad ClearEntry | the Clear Entry key (numeric keypad) |
| Keypad : | the : key (numeric keypad) |
| Keypad , | the Comma key (numeric keypad) |
| Keypad D | the D key (numeric keypad) |
| Keypad && | the && key (numeric keypad) |
| \| | \| key (numeric keypad) |
| Keypad Decimal | the Decimal key (numeric keypad) |
| Keypad / | the / key (numeric keypad) |
| Keypad E | the E key (numeric keypad) |
| Keypad Enter | the Enter key (numeric keypad) |
| Keypad = | the = key (numeric keypad) |
| Keypad = (AS400) | the Equals AS400 key (numeric keypad) |
| Keypad ! | the ! key (numeric keypad) |
| Keypad F | the F key (numeric keypad) |
| Keypad > | the Greater key (numeric keypad) |
| Keypad # | the # key (numeric keypad) |
| Keypad Hexadecimal | the Hexadecimal key (numeric keypad) |
| Keypad { | the Left Brace key (numeric keypad) |
| Keypad ( | the Left Parenthesis key (numeric keypad) |
| Keypad < | the Less key (numeric keypad) |
| Keypad MemAdd | the Mem Add key (numeric keypad) |
| Keypad MemClear | the Mem Clear key (numeric keypad) |
| Keypad MemDivide | the Mem Divide key (numeric keypad) |
| Keypad MemMultiply | the Mem Multiply key (numeric keypad) |
| Keypad MemRecall | the Mem Recall key (numeric keypad) |
| Keypad MemStore | the Mem Store key (numeric keypad) |
| Keypad MemSubtract | the Mem Subtract key (numeric keypad) |
| Keypad - | the - key (numeric keypad) |
| Keypad \* | the \* key (numeric keypad) |
| Keypad Octal | the Octal key (numeric keypad) |
| Keypad % | the Percent key (numeric keypad) |
| Keypad . | the . key (numeric keypad) |
| Keypad + | the + key (numeric keypad) |
| Keypad +/- | the +/- key (numeric keypad) |
| Keypad ^ | the Power key (numeric keypad) |
| Keypad } | the Right Brace key (numeric keypad) |
| Keypad ) | the Right Parenthesis key (numeric keypad) |
| Keypad Space | the Space key (numeric keypad) |
| Keypad Tab | the Tab key (numeric keypad) |
| key (numeric keypad) | |
| Keypad XOR | the XOR key (numeric keypad) |
| L | |
| Left Alt | alt, option |
| Left Ctrl | |
| Left | the Left arrow key (navigation keypad) |
| [ | |
| Left GUI | windows, command (apple), meta |
| Left Shift | |
| M | |
| the Mail/eMail key | |
| MediaSelect | the Media Select key |
| Menu | |
| - | |
| ModeSwitch | I'm not sure if this is really not covered by any of the above, but since there's a special KMOD_MODE for it I'm adding it here |
| Mute | |
| N | |
| Numlock | the Num Lock key (PC) / the Clear key (Mac) |
| O | |
| Oper | |
| Out | |
| P | |
| PageDown | |
| PageUp | |
| Paste | |
| Pause the Pause / Break key | |
| . | |
| Power | The USB document says this is a status flag, not a physical key - but some Mac keyboards do have a power key. |
| PrintScreen | |
| Prior | |
| Q | |
| R | |
| Right Alt | alt gr, option |
| Right Ctrl | |
| Return | the Enter key (main keyboard) |
| Return | |
| Right GUI | windows, command (apple), meta |
| Right | the Right arrow key (navigation keypad) |
| ] | |
| Right Shift | |
| S | |
| ScrollLock | |
| Select | |
| ; | |
| Separator | |
| / | |
| Sleep | the Sleep key |
| Space | the Space Bar key(s) |
| Stop | |
| SysReq | the SysReq key |
| T | |
| Tab | the Tab key |
| ThousandsSeparator | the Thousands Separator key |
| U | |
| Undo | |
| Up | the Up arrow key (navigation keypad) |
| V | |
| VolumeDown | |
| VolumeUp | |
| W | |
| WWW | the WWW/World Wide Web key |
| X | |
| Y | |
| Z | |
| # | ISO USB keyboards actually use this code instead of 49 for the same key, but all OSes I've seen treat the two codes identically. So, as an implementor, unless your keyboard generates both of those codes and your OS treats them differently, you should generate SDL_SCANCODE_BACKSLASH instead of this code. As a user, you should not rely on this code because SDL will never generate it with most (all?) keyboards. |
| & | |
| * | |
| @ | |
| ^ | |
| : | |
| $ | |
| ! | |
| > | |
| # | |
| ( | |
| < | |
| % | |
| + | |
| ? | |
| ) | |
| _ |
These codes were taken from https://wiki.libsdl.org/SDL_Keycode
controls.txt · Last modified: 2019/10/29 12:24 by phulshof
