Keybindings
Keyboard shortcuts and gamepad controls in RetroVoid.
RetroVoid supports full keyboard and gamepad navigation for a console-like experience. All keybindings are fixed. There is no remapping UI or configuration file for controls.
Keyboard Shortcuts
Global
| Shortcut | Action |
|---|---|
| F1 (single press) | Toggle the Quick Settings panel |
| F1 (double press) | Open the full Settings window |
| F11 | Toggle borderless fullscreen (Windows/Linux only) |
| Ctrl+B / Cmd+B | Hide or show the sidebar |
| Escape | Context-aware close: blur input, then close Game Detail, then close the full Settings window, then close Quick Settings, then scroll to top |
Navigation
| Shortcut | Action |
|---|---|
| W | Navigate up |
| S | Navigate down |
| A | Navigate left |
| D | Navigate right |
| Enter | Select / confirm |
Navigation keys repeat after a 400ms initial delay, then every 150ms. They are ignored while a text input or textarea is focused, so typing in the search box or a metadata field works normally.
Note: The arrow keys are not library navigation keys. They are used inside the Media tab only.
Library
| Shortcut | Action |
|---|---|
| Shift + Click | Select a range of games in Grid View (bulk operations) |
| Right-Click | Open the game context menu, or the bulk menu when several games are selected |
| Arrow Left / Right | Move between items in the Media tab, including fullscreen |
| Escape | Close the fullscreen media viewer |
Gamepad Controls
RetroVoid supports any controller recognized by the browser's Gamepad API. Controllers are detected automatically.
Standard Button Mapping
| Button | Index | Action |
|---|---|---|
| A / Cross | 0 | Select / confirm |
| B / Circle | 1 | Back / close (context-dependent) |
| X / Square | 2 | Clear the search field, or pick a playlist up to reorder it |
| Y / Triangle | 3 | Cycle view mode, or type a space on the virtual keyboard |
| LB / L1 | 4 | Previous tab in Game Detail |
| RB / R1 | 5 | Next tab in Game Detail |
| LT / L2 | 6 | Toggle shift on the virtual keyboard |
| RT / R2 | 7 | Confirm input on the virtual keyboard |
| View / Back / Select / Share | 8 | Hide or show the sidebar, from anywhere |
| L3 (Left Stick Click) | 10 | Toggle shift on the virtual keyboard |
| D-Pad | 12 to 15 | Navigation (Up / Down / Left / Right) |
| Left Analog Stick | Axes 0 and 1 | Navigation (dead zone: 0.5) |
| Right Analog Stick, vertical | Axis 3 | Smooth scrolling |
Held directions repeat on the same 400ms then 150ms timing as the keyboard.
Context-Specific Controls
Controls adapt based on which part of the UI is active:
Top Bar
- D-pad moves between the sidebar toggle, search, the sort controls, the three view buttons, and settings
- A activates the focused item
- B closes an open dropdown
- X clears the search field
- Y cycles through view modes
The 3D shelf's Shelves: sort control is mouse only and is not reachable by D-pad.
Grid and List Views
- D-pad moves between games
- D-pad left from the leftmost column moves to the Sidebar; D-pad up from the top row moves to the Top Bar
- A opens game detail
- B scrolls back to the top of the library
- Y cycles through view modes
- Right stick scrolls the library, and the next D-pad press refocuses a game that is actually on screen
Sidebar
- D-pad moves through quick filters, playlists, and platforms
- D-pad left from the library enters the sidebar; if the sidebar is hidden, it reveals itself first
- Right stick scrolls whichever list currently has focus, the playlists or the platforms
- X picks up the focused playlist, then D-pad up and down moves it, A saves, B cancels
Game Detail
- D-pad moves between the action buttons
- A triggers the focused action
- B closes the detail view
- LB / RB switch between the Details and Media tabs
Quick Settings
- D-pad moves between the toggles and the theme tiles
- A toggles or activates the focused item
- B closes the panel
Full Settings
The full Settings window is mouse and keyboard only. Opening it with a controller shows a prompt to switch to mouse navigation; B closes it.
Virtual Keyboard (gamepad text input)
- D-pad moves between keys
- A types the selected key
- B backspace, or close when the field is empty
- Y types a space
- LT / L3 toggle shift
- RT confirms input
Gamepad Detection
- Controllers are polled every 500ms.
- A button press is required before a controller is recognized (this filters out phantom controllers reported by some Windows drivers).
- A controller icon appears in the top bar while one is connected, with the controller's name as its tooltip.
- Toast notifications appear when controllers connect or disconnect.
- The mouse cursor hides while you navigate with the gamepad and returns as soon as you move the mouse.
Note: Gamepad controls in RetroVoid only apply to the launcher's UI. In-game controls are configured through each emulator's own settings.
macOS note: Some Bluetooth controllers are not exposed to WebKit's Gamepad API and therefore are not detected by RetroVoid, even though they work in native emulators.