// OPENBOX DOCS
Keyboard & Controller Shortcuts
Complete hotkey and gamepad bindings for the library, the tools menu, and Big Box kiosk mode.
OpenBox is designed for seamless navigation whether you are sitting at a desktop with a mechanical keyboard or holding a Steam Deck on the couch. Most of the library and reader keys below are defaults you can change in Settings → Controller. Help & shortcuts (F1 or ?) shows a short static list in the app; this page is the authoritative list.
Interactive Controller & Hotkey Reference
Gamepad navigation mappings for Steam Deck, handhelds, and desktop keyboard
Spawns the selected title or enters submenu
Returns to previous view or exits Big Box
Pins or unpins game from Favorites collection
Jumps to a random title in the current list
Moves selection through cards and carousel
Rapidly pages backward and forward through library
Opens running session pause, resume, and kill menu
Opens quick platform, playlist, and sort filter menu
Help & shortcuts
Press F1 or ? anywhere outside a text field and dialogs to open Help & shortcuts, also in the Tools menu. It has three tabs:
- Start here — cards for adding games, setting up emulators, fetching artwork, and playing, plus buttons to reopen setup, open Library checkup, and report an issue.
- Glossary — plain-language definitions of shelf, emulator, ROM, BIOS, metadata, artwork, profile, playlist, collection, Big Box, and resume.
- Shortcuts — a short static list (
Ctrl/Cmd+K,/,Enter, the arrow keys,F,Shift+M,Esc, andF1/?). It is a frozen table in the app and does not reflect remapped bindings, so use this reference page for the full, current set.
Desktop Keyboard Shortcuts
| Shortcut | Action | Description |
|---|---|---|
| Ctrl + , | Settings | Opens the global settings dialog. Rebindable as Open settings. |
| Ctrl / Cmd + K | Command palette | Searches games and opens actions, settings, and What's New discovery. |
| / | Search | Focuses and selects the search field. Rebindable as Search. |
| Enter | Play / activate | Launches or opens the focused game. Rebindable as Play. |
| Ctrl + Alt + Q | Random Game | Picks a random title from the active collection and focuses it. Fixed binding. |
| Ctrl + Alt + R | Random Game (Alt) | Alternative hotkey for random game picker. Fixed binding. |
| Shift + M | Capture Moment | Captures a note/screenshot for the running or selected game; state capture is added only when the adapter supports Quick Resume. Fixed binding. |
| F | Favorite | Toggles the focused game's Favorite flag in the library grid or list. Rebindable as Favorite. |
| M | Filter and sort menu | Opens the context menu for the focused game in the library. Rebindable as Filter and sort menu. |
| R | Random game | Moves focus to a random game. Rebindable as Random game. |
| PageUp / PageDown | Page | Moves one screen of games back or forward. Rebindable as Previous page / Next page. |
| P | Pause menu | Opens the running-game overlay in Big Box; in the library the key is consumed but has no target. Rebindable as Pause menu. |
| F11 | Fullscreen | Toggles borderless fullscreen window mode. Fixed binding. |
| Escape | Back / dismiss | Clears the selection and blurs the grid, closes active dialogs, the tools menu, or a popup. Rebindable as Back. |
Remapping keyboard and controller bindings
Open Settings → Controller. Every row in this table can be changed there; the settings are stored as keyboard_map and controller_map and take effect when you save Settings.
- Keyboard actions. Play, Back, Favorite, Random game, Previous page, Next page, Pause menu, Filter and sort menu, Search, Open settings, Reader previous page, and Reader next page each have a text field and a Press a key capture button. Click the button, press the combination, and the field fills in. Allowed specs are a single key, a digit,
F1-F12, an arrow,PageUp/PageDown,Home,End,Enter,Escape,Space,Tab,Backspace, or one of those withCtrl,Alt, and/orShiftin front. Modifier-only presses and unsupported keys are refused with a message naming the action and the key. - Clearing a binding. Clear the field (or blank it) and save. An empty entry is dropped rather than stored, so the action becomes unbound.
- Duplicates are refused for keyboard keys. A shortcut already assigned to another action fails validation on the client and again on the server ("is assigned to both …"), and the offending field keeps focus.
- Controller buttons are cleared the same way. The eight controller actions are number inputs for button indices
0-31; empty means unassigned. Clearing one frees that button for another action. - Duplicates ask before swapping for controllers. Type a button that another action already uses and OpenBox asks Swap controller buttons with "Button N is already assigned to X. Swap assignments?". Confirming exchanges the two assignments; declining restores the previous value. Buttons
12-15are the D-pad on most pads and trigger a second confirmation when assigned to an action other than the two paging actions.
Defaults are Play Enter, Back Escape, Favorite f, Random r, Previous page PageUp, Next page PageDown, Pause p, Filter and sort menu m, Search /, Open settings Ctrl+,, and Reader previous/next ArrowLeft/ArrowRight. A remapped Back key does not inherit Backspace: that second key only works while Back is still Escape.
Controller types
Settings → Controller also defines controller types, one per line as id|name|kind. Ids are unique lowercase identifiers (up to 32 characters), names up to 60 characters, kind must be one of the built-in kinds, and at most 40 types are accepted. The defaults are Gamepad, Arcade stick, Racing wheel, Light gun, Paddle, Trackball, Spinner, Keyboard, Mouse, and VR.
The game editor's Controller support field has a selectable chip for every configured type, and the text field stays editable for values outside the list. Library cards show one badge per type the game supports. Values already on a game that are no longer in your type list are kept and marked "(existing value)" so saving the dialog does not silently drop them. Those same values feed the controller filter, so the type list is what your library filters by.
Library Grid Keyboard Navigation
These move the focus in the library grid and list once nothing is typing and no dialog is open.
| Shortcut | Action |
|---|---|
| ArrowRight / ArrowLeft | Next / previous game |
| ArrowDown / ArrowUp | Move one row (by the current column count) |
| PageDown / PageUp | Move one screen of games |
| Home / End | Jump to the first / last game |
| Escape | Clear the current selection and blur the grid |
Reader Keyboard Navigation
The document reader uses two rebindable actions, Reader previous page and Reader next page, defaulting to the arrow keys. These are separate from the library bindings, so the arrows can page a manual without moving the grid behind it.
| Shortcut | Action |
|---|---|
| ArrowLeft | Previous page (default for Reader previous page; rebindable in Settings → Controller) |
| ArrowRight | Next page (default for Reader next page; rebindable) |
| Home | First page (fixed) |
| End | Last page (fixed) |
| Escape | Close the reader (uses the Back binding, default Escape) |
Theme (light/dark) and layout (single/spread) are toggled with the reader's own buttons and persist across sessions. See Big Box and handhelds for where documents and manuals open.
Command Palette Navigation
| Shortcut | Action |
|---|---|
| ArrowDown / ArrowUp | Move through palette results |
| Enter | Run the highlighted result |
| Escape | Close the palette |
Arcade Room Keyboard Navigation
| Shortcut | Action |
|---|---|
| ArrowLeft / ArrowRight | Move between cabinets |
| ArrowUp / ArrowDown | Move between zones within a cabinet |
| Home / End | Jump to the first / last entry |
| Enter | Show the current game |
| Space / P | Launch the current game |
| M | Toggle Museum (kiosk) mode; any key leaves it |
| Escape / Backspace | Leave Arcade Room |
Tools Menu Keyboard Navigation (WAI-ARIA)
| Shortcut | Action | Description |
|---|---|---|
| Type in Filter tools… | Filter | Filters the menu items as you type. |
| ArrowDown / ArrowUp | Navigate Items | Cycles through the filtered tools dropdown items with circular wrapping. |
| Enter | Activate | Activates the focused tool. |
| Home / End | First / Last | Jumps focus to the first or last tools menu option. |
| Escape | Clear / Close | Clears the filter field first; when the field is empty, dismisses the menu and returns focus to the Tools trigger button. |
| Tab | Exit Focus | Closes the menu when tabbing away. |
Big Box Keyboard Navigation
The same keyboard_map bindings drive Big Box, so a key you remap for the library changes here too.
| Shortcut | Action | Description |
|---|---|---|
| ArrowLeft / ArrowUp | Previous | Moves back through the cover flow. |
| ArrowRight / ArrowDown | Next | Moves forward through the cover flow. |
| Enter | Launch / Confirm | Launches the selected game, confirms a screensaver pick, or applies the focused menu action. Rebindable as Play. |
| P | Session Control | Opens the running session control overlay (pause, resume, kill). Only acts when a session is running. Rebindable as Pause menu. |
| M | Filter Menu | Opens the Big Box platform, playlist, and sort filter menu. Rebindable as Filter and sort menu. |
| R | Shuffle | Jumps to a random title in the current list. Rebindable as Random game. |
| F | Favorite | Toggles the Favorite flag on the active title. Rebindable as Favorite. |
| Space | Video pause | Pauses or resumes the Big Box preview video while one is showing. |
| F | Video fullscreen | While a preview video is showing, requests fullscreen (the video handler takes precedence over the favorite binding). |
| ArrowUp / ArrowDown | Video volume | While a preview video is showing, raises or lowers the volume by 0.05 (the video handler takes precedence over navigation). |
| Escape | Back / Exit | Blurs the Big Box search field, closes the filter menu or the pause overlay, or exits Big Box mode on a tap. Holding Back opens the Big Box menu instead; the hold time defaults to 0.8 s and is configurable from 0 to 2 s (0 exits immediately). The top-bar Exit button also leaves Big Box. |
| Backspace | Back / Exit | Same as Escape while Back is still bound to Escape. |
1.11 deep-link shortcuts
The CLI can dispatch openbox://resume/<id>, openbox://moment/<id>, and openbox://clip/<id> for the current release; openbox://launch/<id> is also available for direct play, and the tray menu uses the ?deeplink=launch&id=<id> form. Arcade Room has no registered URI action: open it from Tools or the Ctrl/Cmd-K palette. See Command line and deep links for token, server, and stable-id details.
Context menu
| Shortcut | Action |
|---|---|
| ContextMenu (or Shift + F10) | Open the context menu for the focused game |
| ArrowDown / ArrowUp / Home / End | Move through context menu items |
| Escape / Tab | Close the context menu |
Big Box Gamepad Bindings
OpenBox maps standard gamepad inputs. Every action below uses a button index 0-31, editable in Settings → Controller; clear an index to unassign it, and a duplicate index asks for confirmation before the two assignments are swapped.
| Button | Default Index | Action | Description |
|---|---|---|---|
| A | 0 (play) | Launch / Confirm | Launch centered game / confirm selection |
| B | 1 (back) | Back / Exit | Return to menu / exit Big Box mode |
| X | 2 (favorite) | Toggle Favorite | Toggle Favorite flag for current game |
| Y | 3 (random) | Random Shuffle | Jump to a random game |
| LB / RB | 4 / 5 (page_left / page_right) | Page Scroll | Rapidly page backward and forward through library |
| Select / View | 8 (pause) | Session Control | Open running session pause and management overlay |
| Start / Menu | 9 (menu) | Quick Menu | Open Big Box platform filter and sort menu |
| D-Pad / Stick | Axes / Hats | Directional Navigation | Move focus across game cards and carousel |