// OPENBOX DOCS
Arcade Room and Kiosk mode
Browse a controller-friendly platform showroom and configure its local kiosk convenience boundary.
Arcade Room is a controller-friendly canvas showroom for the library. It groups cabinets by platform, uses available local art and media, and lets you inspect or launch the selected game without leaving the room.
Enter and move around
Open Tools → 3D arcade room, or choose Arcade Room from the Ctrl/Cmd-K command palette. The current UI controls are:
| Control | Action |
|---|---|
| Left / Right | Walk between cabinets in the current platform zone |
| Up / Down | Move between platform zones |
| Home / End | Jump to the first/last cabinet |
| Enter | Open the selected game's details |
| Space or P | Play the selected game |
| M | Toggle Kiosk mode |
| Escape or Backspace | Close the room |
| Gamepad | D-pad/stick navigates; mapped Play, Back, Favorite, and Menu buttons launch, leave, select, and toggle Kiosk mode |
The room uses the same library and media projections as the main UI. Missing cover art or media produces a labeled placeholder; it is not a promise that every cabinet has artwork.
Kiosk mode
Kiosk mode (the Museum mode internally) turns the room into a self-guided exhibit. It shows real facts available in the selected game record—such as title, year, developer, genre, play time, and achievement counts—and advances through the room while the exhibit is idle. Any keyboard, pointer, or controller activity exits Kiosk mode. Users with prefers-reduced-motion: reduce receive a static presentation rather than the animation loop.
Kiosk PIN
The optional Kiosk PIN makes unattended browsing a little less casual. Configure it in Settings → Big Box (Require a PIN before entering Kiosk mode and Kiosk PIN, 4–12 digits) or through the API:
curl -s -X POST \
-H "X-OpenBox-Token: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"pin":"2468","enabled":true}' \
"http://127.0.0.1:$PORT/api/v2/arcade/kiosk/pin"
PINs are 4–12 digits. OpenBox stores only a salted PBKDF2-SHA256 digest locally. GET /api/v2/arcade/kiosk/status reports whether the feature is enabled and whether a PIN is set; POST /api/v2/arcade/kiosk/verify returns only {"ok":true|false}.
This is a convenience boundary for a local exhibit, not account authentication, network access control, or a security guarantee. The API still requires the normal per-launch token. Clear the PIN with {"clear":true,"enabled":false}.
Entry points and caveats
There is no registered openbox://arcade URI in the current parser or SPA. Use Tools or the command palette. openbox://bigbox and ?deeplink=bigbox open Big Box, which is a related fullscreen surface but not a deep link for the Arcade Room itself.
MAME set classification (parent/merged/split/non-merged) is an import-time property, not a room filter — see Importing and Troubleshooting.
For arcade entries, the Big Box running-game panel exposes MAME high scores (show, export, and import) through the same endpoints as the library details pane; see High scores in the running-game panel.
See Big Box and handhelds, Keyboard & Controller Shortcuts, and API 1.11 additions for the related controls and route contract.