// 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

A (Button 0)Launch Game

Spawns the selected title or enters submenu

B (Button 1)Back

Returns to previous view or exits Big Box

X (Button 2)Toggle Favorite

Pins or unpins game from Favorites collection

Y (Button 3)Random Game

Jumps to a random title in the current list

D-Pad / StickCard Focus

Moves selection through cards and carousel

LB / RB (4/5)Page Left / Right

Rapidly pages backward and forward through library

Select / View (8)Pause / Session Menu

Opens running session pause, resume, and kill menu

Start / Menu (9)Open Big Box 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, and F1 / ?). 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

ShortcutActionDescription
Ctrl + ,SettingsOpens the global settings dialog. Rebindable as Open settings.
Ctrl / Cmd + KCommand paletteSearches games and opens actions, settings, and What's New discovery.
/SearchFocuses and selects the search field. Rebindable as Search.
EnterPlay / activateLaunches or opens the focused game. Rebindable as Play.
Ctrl + Alt + QRandom GamePicks a random title from the active collection and focuses it. Fixed binding.
Ctrl + Alt + RRandom Game (Alt)Alternative hotkey for random game picker. Fixed binding.
Shift + MCapture MomentCaptures a note/screenshot for the running or selected game; state capture is added only when the adapter supports Quick Resume. Fixed binding.
FFavoriteToggles the focused game's Favorite flag in the library grid or list. Rebindable as Favorite.
MFilter and sort menuOpens the context menu for the focused game in the library. Rebindable as Filter and sort menu.
RRandom gameMoves focus to a random game. Rebindable as Random game.
PageUp / PageDownPageMoves one screen of games back or forward. Rebindable as Previous page / Next page.
PPause menuOpens the running-game overlay in Big Box; in the library the key is consumed but has no target. Rebindable as Pause menu.
F11FullscreenToggles borderless fullscreen window mode. Fixed binding.
EscapeBack / dismissClears 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 with Ctrl, Alt, and/or Shift in 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-15 are 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.

ShortcutAction
ArrowRight / ArrowLeftNext / previous game
ArrowDown / ArrowUpMove one row (by the current column count)
PageDown / PageUpMove one screen of games
Home / EndJump to the first / last game
EscapeClear 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.

ShortcutAction
ArrowLeftPrevious page (default for Reader previous page; rebindable in Settings → Controller)
ArrowRightNext page (default for Reader next page; rebindable)
HomeFirst page (fixed)
EndLast page (fixed)
EscapeClose 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

ShortcutAction
ArrowDown / ArrowUpMove through palette results
EnterRun the highlighted result
EscapeClose the palette

Arcade Room Keyboard Navigation

ShortcutAction
ArrowLeft / ArrowRightMove between cabinets
ArrowUp / ArrowDownMove between zones within a cabinet
Home / EndJump to the first / last entry
EnterShow the current game
Space / PLaunch the current game
MToggle Museum (kiosk) mode; any key leaves it
Escape / BackspaceLeave Arcade Room

Tools Menu Keyboard Navigation (WAI-ARIA)

ShortcutActionDescription
Type in Filter tools…FilterFilters the menu items as you type.
ArrowDown / ArrowUpNavigate ItemsCycles through the filtered tools dropdown items with circular wrapping.
EnterActivateActivates the focused tool.
Home / EndFirst / LastJumps focus to the first or last tools menu option.
EscapeClear / CloseClears the filter field first; when the field is empty, dismisses the menu and returns focus to the Tools trigger button.
TabExit FocusCloses 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.

ShortcutActionDescription
ArrowLeft / ArrowUpPreviousMoves back through the cover flow.
ArrowRight / ArrowDownNextMoves forward through the cover flow.
EnterLaunch / ConfirmLaunches the selected game, confirms a screensaver pick, or applies the focused menu action. Rebindable as Play.
PSession ControlOpens the running session control overlay (pause, resume, kill). Only acts when a session is running. Rebindable as Pause menu.
MFilter MenuOpens the Big Box platform, playlist, and sort filter menu. Rebindable as Filter and sort menu.
RShuffleJumps to a random title in the current list. Rebindable as Random game.
FFavoriteToggles the Favorite flag on the active title. Rebindable as Favorite.
SpaceVideo pausePauses or resumes the Big Box preview video while one is showing.
FVideo fullscreenWhile a preview video is showing, requests fullscreen (the video handler takes precedence over the favorite binding).
ArrowUp / ArrowDownVideo volumeWhile a preview video is showing, raises or lowers the volume by 0.05 (the video handler takes precedence over navigation).
EscapeBack / ExitBlurs 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.
BackspaceBack / ExitSame as Escape while Back is still bound to Escape.

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

ShortcutAction
ContextMenu (or Shift + F10)Open the context menu for the focused game
ArrowDown / ArrowUp / Home / EndMove through context menu items
Escape / TabClose 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.

ButtonDefault IndexActionDescription
A0 (play)Launch / ConfirmLaunch centered game / confirm selection
B1 (back)Back / ExitReturn to menu / exit Big Box mode
X2 (favorite)Toggle FavoriteToggle Favorite flag for current game
Y3 (random)Random ShuffleJump to a random game
LB / RB4 / 5 (page_left / page_right)Page ScrollRapidly page backward and forward through library
Select / View8 (pause)Session ControlOpen running session pause and management overlay
Start / Menu9 (menu)Quick MenuOpen Big Box platform filter and sort menu
D-Pad / StickAxes / HatsDirectional NavigationMove focus across game cards and carousel