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 Quick Settings panel |
| F1 (double press) | Open full Settings window |
| F11 | Toggle borderless fullscreen (Windows/Linux only) |
| Escape | Context-aware close: blur input → close Game Detail → close Settings → scroll to top |
Navigation
| Shortcut | Action |
|---|---|
| W / Arrow Up | Navigate up |
| S / Arrow Down | Navigate down |
| A / Arrow Left | Navigate left |
| D / Arrow Right | Navigate right |
| Enter | Select / confirm |
Navigation keys repeat after a 400ms initial delay, then every 150ms. Navigation shortcuts are disabled when a text input or textarea is focused.
Library
| Shortcut | Action |
|---|---|
| Shift + Click | Multi-select games in Grid View (bulk operations) |
| Right-Click | Open game context menu |
| Arrow Left / Right | Navigate between media items (in Media tab) |
| Escape | Close 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 (e.g., clear search input) |
| Y / Triangle | 3 | Alt action (e.g., cycle view mode) |
| LB / L1 | 4 | Previous tab |
| RB / R1 | 5 | Next tab |
| LT / L2 | 6 | Context-dependent |
| RT / R2 | 7 | Context-dependent |
| Back / Select | 8 | Context-dependent |
| Start / Options | 9 | Context-dependent |
| L3 (Left Stick Click) | 10 | Context-dependent |
| R3 (Right Stick Click) | 11 | Context-dependent |
| D-Pad | 12–15 | Navigation (Up / Down / Left / Right) |
| Left Analog Stick | Axes 0–1 | Navigation (dead zone: 0.5) |
| Right Analog Y-Axis | Axis 3 | Smooth scrolling |
Context-Specific Controls
Controls adapt based on which part of the UI is active:
Top Bar
- D-pad navigates between items (search, sort, view toggles, settings)
- A activates the focused item
- B closes dropdown menus
- X clears the search field
- Y cycles through view modes
Grid View
- D-pad navigates between game cards
- A opens game detail
- B navigates to Top Bar, then Sidebar
- Y cycles through view modes
- Right stick Y-axis scrolls the library
- Smart focus recovery after scrolling
Game Detail
- D-pad navigates action buttons
- A triggers the focused action
- B closes the detail view
- LB / RB switches between tabs (Details / Media)
- Right stick Y-axis scrolls content
Holographic Shelf
- D-pad Up/Down switches between shelves
- D-pad Left/Right navigates cards within a shelf
- A opens game detail
- Y cycles through view modes
Settings Panel
- D-pad navigates between settings items
- A toggles or activates the focused setting
- B closes the panel
- Theme selection uses 2x2 grid navigation
Virtual Keyboard (gamepad text input)
- D-pad navigates between keys
- A types the selected key
- B backspace or close
- Y types a space
- LT / L3 toggles caps lock
- RT confirms input (done)
Gamepad Detection
- Controllers are polled every 500ms.
- A button press is required before a controller is recognized (filters ghost controllers on Windows).
- The controller name is shown as a tooltip on the connected indicator in the top bar.
- Toast notifications appear when controllers connect or disconnect.
- The mouse cursor auto-hides when the gamepad is active and reappears on mouse movement.
Note: Gamepad controls in RetroVoid only apply to the launcher's UI. In-game controls are configured through each emulator's own settings.