ARCadeOS home
ARCadeOS
Owner’s guide

User Manual

Everything you need to run your ARCade cabinet — from your first game to tuning the controller board inside the control panel. Every feature, what it is for, and how to use it.

Written for ARCadeOS v1.28.96 · © 2026 DIY.Engineering LLC

1Getting started

ARCadeOS is the operating system of the ARCade cabinet by DIY Engineering. It turns the cabinet into a single, controller-first machine: every arcade board, pinball table, console and PC game you own in one place, with artwork, attract video and music — and never a Windows desktop in sight.

You do not need a keyboard or a mouse. Everything in this manual can be done from the joystick and buttons on the cabinet. Your cabinet arrives set up and ready to play, so if you just want to start a game, read section 2 and go. The rest of the manual is here when you want to add games, change how the cabinet looks and sounds, or look after it.

The main screen

This is where you will spend most of your time. Everything is laid out around the game you have currently highlighted.

The ARCadeOS main library screen 1 2 3 4 5 6 7 8
  1. 1 Date and time. An ARCade Share icon and a mute icon appear on the right when relevant
  2. 2 Category tabs: systems, genres and collections
  3. 3 Hero card: the highlighted game, with its preview video playing in a cabinet frame
  4. 4 Play, Details and Favourite (plus Play Online on supported games)
  5. 5 A–Z jump bar
  6. 6 The game grid
  7. 7 Press Start card: the game that will launch
  8. 8 Help and Settings
The main screen. Your cabinet’s background video, artwork and accent colour may differ — the layout is the same.

The setup wizard

The first time a cabinet starts, a ten-step setup wizard runs. Move between steps with Next and Back (or B to step back). Most steps are optional; press Next to skip anything you want to do later.

  1. Welcome to ARCadeOS. A short legal note: ARCadeOS is a game launcher, and you should only add content you own.
  2. Connect to the internet. Pick your Wi-Fi network from the list and type its password with the on-screen keyboard. Hidden network… lets you type a network name that is not broadcast; Other networks… opens the Windows Wi-Fi panel for unusual cases such as a hotel or workplace sign-in page. If the cabinet is cabled to your router you can skip this step.
  3. What makes ARCadeOS great. A one-screen tour of what the cabinet can do.
  4. Choose your experience. Pick the Appearance (follow Windows, light or dark) and whether you want the Full multimedia experience: navigation sounds, jukebox music, launch videos and a background video. Turn it off for a quiet, plain interface; everything can be fine-tuned later.
  5. Your Steam library. Sign in to Steam once and your installed Steam games appear in ARCadeOS automatically.
  6. Game artwork. Optionally paste a free SteamGridDB key, and choose whether to use the LaunchBox artwork database (a one-time download of about 100 MB) for wider artwork coverage.
  7. Christen your cabinet. Your cabinet is given a name with a slot-machine spin. Press Roll again until you find one you like. The name is permanent: it is how your cabinet introduces itself to other ARCade cabinets.
  8. ARCade Share. Choose whether to switch on ARCade Share now. You can change this at any time.
  9. Add your games. Shows the cabinet’s import folder and confirms the artwork database is ready. See section 5.
  10. Thank you. Press Finish and the library opens.
Wizard welcome step
1 · Welcome
Wizard Wi-Fi step
2 · Connect to the internet
Wizard experience step
4 · Choose your experience
Wizard artwork step
6 · Game artwork
Wizard cabinet naming step
7 · Christen your cabinet
Wizard ARCade Share step
8 · ARCade Share

You can run the wizard again at any time from Settings → System → Advanced → Run setup wizard. Re-running it erases nothing, and your cabinet keeps its name.

Startup tips

A few seconds after ARCadeOS starts, a tip slides up at the bottom of the screen with a shortcut or feature you may not have found yet. There are twenty, shown in turn, so you see a different one each time. It disappears by itself after about ten seconds; press any button (or B) to dismiss it sooner. Turn tips off in Settings → Display.

A startup tip at the bottom of the main screen
A startup tip. It never takes focus, so you can keep browsing while it is showing.

2Your controls

Every screen in ARCadeOS is built for a joystick and buttons first. The same handful of controls works everywhere, including inside Settings.

Button reference

Your cabinet’s control panel presents itself to Windows as an Xbox controller (see section 9), so ARCadeOS names its buttons the Xbox way. These are the defaults:

ButtonWhat it doesKeyboard
ALaunch / Select. Activates whatever is highlighted. On a game tile it moves you to the Play button; press A again to start the game.Enter
BBack. Leaves the current screen, closes a card, answers “No” to a question, or returns to the grid.Esc / Backspace
XFavourite. Adds or removes the highlighted game from Favourites.F
YDetails. Opens the game’s details screen.I
StartSettings. Opens Settings from anywhere. Also the Start game button inside games.S
Back / SelectMute. Silences and un-silences everything instantly; a speaker icon shows while muted. Also the Insert coin button inside games.M
LB / RBPrevious / next category tab. Inside a long card (Settings, Help, a report) they scroll a page at a time.Q / E
LT / RTPrevious / next music track while you browse.Media keys
D-pad / stickMove around the grid, the tabs, the A–Z bar and every menu. Held directions repeat.Arrow keys
unassignedPlay online. Opens online play for a supported game. Assign it a button in Settings → Controls → Menu navigation if you use it often — otherwise use the Play Online button on screen.O
unassignedHelp. Opens Help & Controls. Use the Help button on screen, or assign it a button.H
Start + Back (hold)Quit the running game. On the main screen it offers to shut the cabinet down.—

Moving around screens

  • In the grid, push up from the top row to reach the hero card, then the tabs. Push down from the bottom row to reach Help and Settings. Push left from the first column to reach the A–Z bar.
  • In any card (Settings, the importer, an editor): up / down moves between items; left / right changes a slider or a drop-down list without opening it; A presses a button, ticks a box or opens a list; B closes the card. With a list open, B closes just the list.
  • In a file or folder browser, A opens a folder or picks a file, left goes up a folder, and B cancels.
  • Setting a button (any “Press…” box): press the button or key you want. If you change your mind, just wait — it cancels itself after ten seconds. B is not a cancel here, because B is a button you may want to assign.

Quitting & power

Quitting a game

Once you are inside a game, ARCadeOS steps aside. Hold Start and Back together to quit and come straight back to your library. This works in every arcade emulator, console emulator and pinball table. You can choose a different pair in Settings → Controls → Coin, Start & Exit.

Hold the same two buttons on the main screen and ARCadeOS asks “Shut down the system now?” — choose Shut down or Cancel. Restart, sleep and shut down are also in Settings → System → Power. If ARCade Share is still downloading something, ARCadeOS warns you first and offers Keep downloading.

On-screen keyboard

Whenever you need to type — a Wi-Fi password, a nickname, an API key — highlight the text box and press A. An on-screen keyboard appears: move with the stick, press A on each key, Shift for capitals, &123 for symbols, ⌫ Back to delete, and Done when you are finished.

The on-screen keyboard
The on-screen keyboard, opened by pressing A on a text box.

Help & Controls

The Help button at the bottom of the main screen opens a card with your cabinet’s current button map (including any changes you have made) and short how-tos for navigating, playing, music, importing, ARCade Share and customising the controls. Scroll it with the stick or LB/RB; close it with A or B.

The Help and Controls card
Help & Controls.

3Browsing your library

Categories & genres

The row of tabs across the top splits your library up. Move between tabs with the shoulder buttons (LB and RB) from anywhere — much faster than walking up to the tab row. The tabs wrap around, so LB on the first tab jumps to the last.

By default there is a tab for each system you own games for (MAME, Visual Pinball, Future Pinball, the consoles, Steam and your other launchers), plus:

  • All Games — everything, A to Z.
  • Favorites, Recent and Most Played — see below.
  • ARCade Share — only when ARCade Share is switched on.

Prefer to browse by the kind of game? Set Settings → Display → Tab mode to Genre. The system tabs are replaced by genre tabs: Classics (golden-age arcade games from 1984 and earlier, which also stay in their own genre), Fighters, Beat ’em Ups, Shmups, Shooters, Platformers, Action, Maze, Racing, Sports, Puzzle, Adventure, RPG, Simulation, Strategy, Pinball, Casino & Cards, Music, Quiz — and Other for anything ARCadeOS can’t place. Only genres you actually have games in are shown. If a game lands in the wrong genre, fix it in its Edit card.

Genre tab mode showing the Beat 'em Ups tab
Genre tab mode, on the Beat ’em Ups tab.

Tabs can show a platform logo, a name, or both: Settings → Display → Platform tabs.

The hero card

The large card above the grid always follows the game you have highlighted. It shows the game’s logo, year, maker and number of players, and plays its preview video — silently, inside the same cabinet frame (bezel) the game will use when it runs. Its buttons are Play, Details and the heart (favourite), plus Play Online on games that support it. The small letter on each button is the controller button that does the same thing, and it follows any changes you make to your controls.

The A–Z jump bar

The narrow strip of letters down the left edge is the fastest way through a large library. Push left from the first column of the grid to hop onto it, move up and down to a letter, then press right or A to drop back into the grid at that letter. # covers titles that start with a number or symbol. The bar only lists letters you actually have games for, so there are no dead stops.

Favourites & history

Press X on any game to favourite it — a heart appears on its tile and it shows up immediately in the Favorites tab. Press X again to remove it.

Recent and Most Played build themselves as you play; you never have to curate them.

To choose which tab ARCadeOS opens on, use Settings → Display → Opens on — pick a tab, or (Last used) to carry on where you left off.

Attract mode

Leave the cabinet alone for a while (five minutes by default) and it goes into attract mode, just like an arcade machine on location. It plays the preview videos of your games full-screen, framed by the cabinet bezel and topped with each game’s marquee, in a shuffled order. If none of your games have preview videos it shows a slideshow of their artwork instead.

Press any button to come back. That first press only wakes the cabinet — it never launches anything by accident. Attract mode never starts while a card or menu is open. Change the delay, or turn it off, in Settings → Ambience & attract → Attract mode.

Attract mode playing a pinball preview video
Attract mode.

4Playing games

Launching & quitting

  1. Highlight a game in the grid.
  2. Press A to move to Play, then A again.
  3. A short launch video plays while ARCadeOS starts the right emulator with the right settings for that game, and — on cabinets with a joystick restrictor — switches the joystick to 4-way or 8-way. Nothing to configure.
  4. Insert coins with Back and start with Start, as on an arcade machine.
  5. To come back, hold Start and Back together.

If a game cannot start because something is missing — an emulator, a core, a BIOS file — ARCadeOS tells you what is missing instead of failing silently, and offers Open Systems to fix it. See systems readiness.

The details screen

Press Y on any game for its full page: box art, logo, title, year, maker, number of players, genre, joystick type and description.

A game details screen
The details screen.
ButtonWhat it does
BackReturns to the grid (or press B).
PlayStarts the game.
Play OnlineOnly on games that support online play. See Playing online.
FavoriteAdds or removes the game from Favourites.
Edit art & detailsOpens the game’s Edit card — see below.
ShareOffers this game to other cabinets over ARCade Share. Shows Shared ✓ once it is offered. Only appears when ARCade Share is on.

Editing a game

Edit art & details opens a card with everything ARCadeOS knows about the game, in folding sections. Changes are saved as you make them; press Done when you are finished.

The Edit art and details card with the Joystick section open
Edit art & details, with the Joystick section open.
SectionWhat it is for
ArtworkThe game’s Box art, Logo / icon, Background and Marquee. Set… picks an image file; Find looks in your media library and then online, and shows a grid of choices to pick from. For the marquee, Generate builds one from the game’s logo and art. Use this when an automatic match picked the wrong regional release.
Preview videoThe clip that plays on the hero card and in attract mode. Set… or Clear, plus the global preview volume.
DetailsChange the game’s Name (or press Name from file for the name its file gives; arcade games get MAME’s title), then Save name. Edit the description, then Save description.
JoystickJoystick ways: 4-way or 8-way. The gate the cabinet’s joystick restrictor moves to when this game launches. 4-way suits maze and climbing games (Pac-Man, Donkey Kong); 8-way suits everything else. ARCadeOS detects this automatically for MAME games — change it here if it is wrong. See Joystick restrictor.
GenreWhich genre tab the game appears under in Genre tab mode. Automatic shows the genre ARCadeOS worked out; pick another to override it.
Launch optionsAdvanced, emulator games only: Extra arguments added to the emulator’s command line, a Custom command override, and a Working directory. Save launch options applies them; Reset to default undoes them.
Delete gameRemoves the game from the library. The game file itself is left on disk, so you can import it again later.

Playing online

Console games run through RetroArch can be played online with a friend on another cabinet or PC. A Play Online button appears on the hero card and details screen of every game that supports it. Arcade (MAME) games and pinball tables cannot be played online.

A console game with the Play Online button
Play Online on a supported game.
The Play Online card
The Play Online card.
  • Host a session starts the game and waits for a friend. Add a password under Lock with a password if you want to keep it private. Your hosted game is listed in the public lobby unless you turn that off in Settings.
  • Join by address connects to a friend who has given you their address (and password, if they set one).
  • Browse public games… lists sessions that are open right now; pick one and press Join.

Both players need the same game file and the same emulator version. By default the connection goes through a free relay server, so there is no router configuration to do. Your nickname, relay region and lobby listing are in Settings → Network & sharing → Online multiplayer.

Music & sound

ARCadeOS can play jukebox music while you browse, a background video behind everything, a short video as each game launches, and quiet clicks as you move. The triggers skip music tracks; Back mutes everything at once. Every volume in the cabinet lives together in Settings → Sound, so you can balance them in one place, and music and background audio can fade out automatically while you play.

5Adding games

You supply the games; ARCadeOS does the presentation. It works out which system each file belongs to, finds artwork, descriptions and release details, and installs the emulator that system needs.

Your responsibility

Only add games you legally own — for example ROMs dumped from boards, cartridges or discs you own, your own pinball tables, or games licensed to you.

From a USB drive (the easy way)

  1. Plug any USB drive into the cabinet. If the drive is blank, ARCadeOS asks Set up this USB drive? — choose Yes, set it up. It creates a folder called ARCadeOS Import Folder with a sub-folder for every system it supports.
  2. Take the drive to your computer and copy your games into the matching sub-folders. If you have your own artwork or videos, put them in the Media sub-folders.
  3. Plug the drive back into the cabinet. The importer opens by itself and scans it.

From a folder on the cabinet

Open Settings → Games & library → Open importer, choose Browse… to pick a folder (a drive you have already copied games onto, or a network share), and press Scan. The cabinet also has its own import folder; when the library is empty, a Scan for games button on the main screen scans it in one press.

Reviewing an import

After a scan, the importer lists what it found, grouped by system, each with a status badge. Use the platform filter, Select all and None to choose, then press Import N selected. When it finishes, Import Results shows which systems were set up and how complete each game’s artwork is (green, yellow or red). Re-scanning is always safe: games already in your library are skipped.

Settings, Games and library section
Settings → Games & library.
The importer scanning a folder
The importer scanning a folder. Large collections take a few minutes.

If you would rather skip the review step, or stop the importer opening on its own, see Folders & import behaviour.

Systems readiness

Settings → Games & library → Check systems readiness… lists every system in your library with its status: Ready, Needs core, Needs BIOS, Not installed or Manual setup, with advice for each. Anything ARCadeOS can fix has an Install button. Press Re-check after fixing something.

The Systems readiness card
Systems readiness. BIOS files are the one thing ARCadeOS cannot download for you — you need to supply them from hardware you own.

Artwork

Artwork comes from public databases (Libretro, LaunchBox, SteamGridDB, and VPS for pinball tables). Most of it is found without any setup. For the widest coverage you can add your own free API keys for RAWG and SteamGridDB in Settings → Games & library → Artwork sources; each has a Get a free key… button.

Update all artwork (in Settings → Games & library → Library tools) looks up box art for every game again. A progress line shows how far it has got, and a summary appears at the end. Nothing is lost: art it replaces is kept in an artwork-backup folder in each library, where nothing better is found the existing card is kept, and a game with no card at all gets a tile made from its title and system.

To fix a single game, use Edit art & details → Find on that game instead.

6ARCade Share

ARCade Share lets your cabinet swap games directly with other ARCade cabinets. There are no accounts to create, no servers to pay for, and no router configuration. It is off until you turn it on, and it only ever offers the games you pick.

Turning it on

Go to Settings → Network & sharing → ARCade Share → Open ARCade Share… and press Turn on ARCade Share. The first time, a short Before you turn this on notice explains what sharing means; press I understand to continue. The first start takes a minute or two while the cabinet sets up its private connection; after that it is automatic.

Sharing your games

Two ways, both opt-in:

  • From a game’s details screen, choose Share. That single game is now offered.
  • From the ARCade Share panel, open a category under Shared games and tick individual games, or use Share all / Unshare all for the whole category — useful for offering, say, all your pinball tables.

Nothing is shared until you tick it, and un-ticking withdraws it immediately.

Downloading from another cabinet

With ARCade Share on, an ARCade Share tab appears in the tab row. It has one section for each cabinet that is online and sharing (“name is sharing N games”), and a section for what you are sharing. While it looks for cabinets it shows Finding cabinets on the network….

Games you do not have yet appear in greyscale. Highlight one and press Download. The tile fills with colour as it arrives, showing the percentage as it goes, and a message confirms when it lands in your library — complete with its artwork. A game you already own shows in full colour with a Play button instead, so you are never offered a duplicate. When another cabinet comes online, a message tells you.

The ARCade Share tab
The ARCade Share tab, looking for other cabinets.
The ARCade Share panel
The ARCade Share panel.

The Share panel

Open it from Settings, or with View status on the ARCade Share tab.

PartWhat it shows or does
This cabinetYour cabinet’s name, whether it is online, and how many games you share. Your private address is shown shortened; Copy address copies it in full.
Network blocking Tor? (bridges)If ARCade Share stays on “Connecting…”, your network may be blocking it. Tick Always use bridges, or paste bridge lines you have been given. ARCade Share also retries by itself and tells you the likely cause (no internet, wrong clock, blocked).
Cabinets onlineThe other cabinets you can see right now.
TransfersDownloads in progress and finished.
Shared gamesWhat you offer, by category, with Share all / Unshare all.
Auto-downloadTick a system and anything new that other cabinets share for it downloads by itself.
Turn off ARCade ShareStops everything immediately.

Privacy

ARCade Share runs over the Tor network. That means your cabinet is reachable by its private address only — not by your home IP address — and there is nothing to forward on your router.

  • You share only the games you tick.
  • Your cabinet is identified by the name it was christened with, nothing more.
  • Turning ARCade Share off stops everything immediately.
Please note

ARCade Share is a tool for moving your own files between your own machines, and for sharing content you have the right to share. What you choose to offer is your responsibility.

7Settings, section by section

Settings is organised into nine sections, ordered by how often people use them. The specialist controls are folded away inside each section, so the list stays short.

Open Settings with Start from anywhere (or the Settings button). Move with the stick, open a section with A, change a value with left / right, and back out with B. Changes take effect immediately — there is no Save button.

Tip: click any screenshot in this manual to see it full size.

Settings with every section folded
The nine sections, all folded.
Settings, Display section
Display, open by default.

Display

SettingWhat it does
ThemeFollow OS, Light or Dark.
Accent colourNine colours. Re-themes the whole frontend in one press — buttons, highlights, focus rings.
Platform tabsHow system tabs look: Logo + Text, Logo only, or Text only.
Tab modePlatform (a tab per system) or Genre (Classics, Fighters, Shmups, Pinball…). See Categories & genres.
ScreenSets the screen’s orientation every time ARCadeOS starts: Leave the screen alone, Portrait (rotated left or right), Landscape, or Landscape (upside down). Apply now applies it straight away. Useful if a replaced monitor comes back up the wrong way round.
Tile columnsHow many game tiles fit across the grid (2–10).
Opens onThe tab shown when ARCadeOS starts, or (Last used).
Start full screenStarts ARCadeOS full screen.
24-hour clockShows the time as 14:30 instead of 2:30 PM.
Show a tip when ARCadeOS startsTurns startup tips on or off.
Fine-tuning (folded)Card shadow and Edge glow strength.

Sound

Settings, Sound section
Sound — every volume in one place.
SettingWhat it does
Music
Music folderThe folder of music the jukebox plays. Set… to choose, Clear for no music.
Shuffle music on startupStarts at a random track each time.
Music volumeJukebox loudness.
Fade out music during gameplaySilences the jukebox while a game is running.
Startup
Play a sound when ARCadeOS startsA start-up sound, played in full before the start-up video. Silent while the cabinet is muted.
SoundChoose… your own sound file, or Default for the ARCadeOS sound.
Sound volumeStart-up sound loudness.
Navigation
Play a sound when navigating / Sound volumeThe soft clicks as you move around and open cards.
Video
Game previewsVolume of preview videos (the hero card plays them muted; attract mode and the editor use this).
Launch videosVolume of the clip that plays while a game starts.
Background videoVolume of the background video (only shown when one is set).
Fade out background audio during gameplaySilences the background video while a game is running.

Games & library

Folders and import behaviour
Folders & import behaviour
Emulators
Emulators
Artwork sources
Artwork sources
SettingWhat it does
Open importerOpens the importer. See Adding games.
Check systems readiness…Opens the Systems card.
Library tools (folded)
Update all artworkLooks up art for every game again. See Artwork.
Find duplicate gamesLists games that are in a collection more than once (the same file name, ignoring region and version tags). You pick the copy to keep; the others are hidden, and their files stay on disk.
Restore hidden duplicatesBrings back every copy Find duplicate games hid.
Fix shared namesLists different games that were given the same name (a wrong artwork match can do this) and renames the ticked ones from their file names; arcade games get MAME’s title.
Folders & import behaviour (folded)
Library folderWhere imported games are stored.
Import folderA folder on the cabinet the importer scans, as an alternative to a USB drive.
Media folderWhere artwork and videos are kept.
Importing a game that’s already in the librarySkip, Overwrite or Keep both.
Open the importer when a USB drive is plugged inThe automatic USB import described above.
Import automatically, without a review stepSkips the review list and imports everything found.
Ask me for artwork when none is foundOffers the image picker for games no database knows.
Emulators (folded)
One row per emulatorIts status, a version picker where several versions are available, Install (or Get… for ones you download yourself), Set… to point at a copy you installed, and Clear.
Artwork sources (folded)
Use LaunchBox Games DatabaseNo key needed; a one-time download of about 100 MB that greatly improves arcade and console artwork.
RAWG key / SteamGridDB keyOptional free keys for more console and PC artwork. Type the key and press Save; Get a free key… opens the sign-up page. Keys are stored encrypted on the cabinet.

Controls

Seven folded panels. Your cabinet ships with these already set to match its control panel; you only need them if you add hardware or prefer a different layout.

Menu navigation
Menu navigation
Coin, Start and Exit
Coin, Start & Exit
Arcade games
Arcade games
Pinball tables
Pinball tables
Cabinet hardware
Cabinet hardware
Stream Deck
Stream Deck
PanelWhat it is for
Menu navigationThe buttons that drive ARCadeOS itself: Launch / Select, Back, Favorite, Details, Play online, Settings, Previous / Next tab, Previous / Next song, Mute audio, Help. For each, pick a controller button from the list, and/or press Set and press a keyboard key — useful for extra panel buttons, encoders or joy2key-style devices that send keys. Picking a button another action already uses swaps the two. Reset to defaults restores the standard map. Moving is always the stick or d-pad.
Coin, Start & ExitShared by every emulator and pinball program, so the same buttons do the same thing everywhere. Insert coin (default Back), Start game (default Start), and Quit a game by holding two buttons together (default Start + Back).
Arcade gamesOne map for every arcade game: the joystick and Buttons 1–6 plus Menu select. With Auto-configure MAME & RetroArch from this map ticked, ARCadeOS writes it into MAME’s configuration and RetroArch for you. MAME overrides and RetroArch overrides (folded) change a single input in one program only.
Pinball tablesOne map for Visual Pinball and Future Pinball: Left / Right flipper, Plunger, Launch / lockbar, Nudge left / right / forward, and Left / Right MagnaSave. Folded overrides let you adjust either program separately or turn gamepad input off for it.
Cabinet hardwareSpinner, trackball, joystick restrictor and nudge sensor. See section 8.
Stream DeckThe six-key Stream Deck module. See Stream Deck.
Other emulatorsMAME and RetroArch are set up from the maps above. Each row here has an Open setup button that opens that emulator’s own control setup, for fine-tuning something ARCadeOS doesn’t cover.

Ambience & attract

Background video
Background video
Bezels
Bezels
Launch video
Launch video
PanelWhat it is for
Background videoA video looped behind the whole frontend. Video file (Set… / Clear), Opacity, Pick a random video from this folder at startup, and Play the next clip when one ends, instead of looping.
BezelsThe cabinet frame games are shown in — on the hero card, in attract mode, and in MAME and RetroArch while you play. Landscape and portrait games each get their own: Choose… picks a PNG whose screen opening (and marquee slot, if any) is transparent; Use built-in goes back to the ARCade frame. MAME games change straight away; a RetroArch game’s frame is rebuilt the next time it launches.
Launch videoThe short clip played while a game starts. A Default video plus optional Per-category overrides (a different clip for pinball, NES, and so on), each with Fade in, Hold and Fade out times.
Attract modePlay an attract loop when idle and Start after (1–30 minutes). See Attract mode.

Network & sharing

Wi-Fi
Wi-Fi
ARCade Share
ARCade Share
Online multiplayer
Online multiplayer
PanelWhat it is for
Wi-FiJoin or change Wi-Fi networks from the controls, exactly as in the setup wizard: press A on a network, type the password with the on-screen keyboard, then Connect. Refresh rescans; Hidden network… lets you type a network name; Other networks… opens the Windows Wi-Fi panel. If Windows needs location access to list networks, a Location settings… button appears.
ARCade ShareCurrent status and Open ARCade Share…. See section 6.
Online multiplayerNickname shown to other players; Use a relay server (no router port-forwarding needed — leave on); Relay region (pick the nearest); List my hosted games in the public lobby; and the Port used when not relaying.

Updates

The version this cabinet is running, Check for updates, and the three automatic-update switches. See section 10.

System

System
System
Launch helpers
Launch helpers
Advanced
Advanced
SettingWhat it does
PowerRestart, Shut down and Sleep the cabinet, or Exit ARCadeOS to the Windows desktop (for maintenance; it starts again at the next power-on).
StartupOn a cabinet: Start ARCadeOS when the cabinet powers on and Restart ARCadeOS automatically if it closes. Leave both on.
BackupExport… saves all settings, favourites, play history and per-game edits to a single .zip — a backup, or a way to copy your setup to another cabinet. Import… restores one (then asks to restart). API keys are not included.
Launch helpers (folded)Companion programs, such as joy2key or AutoHotkey scripts, started around a game launch and closed when it exits. Add helper… lets you choose the program, its arguments, whether it runs before or after the game starts, and which emulators it applies to.
Advanced (folded)Run setup wizard re-runs the wizard without erasing anything. On a cabinet you will also find Re-apply optimizations…, which re-applies the cabinet’s Windows tuning, and Reset to a normal PC…, which removes it.
Reset to a normal PC

This turns the cabinet back into an ordinary Windows PC (no automatic start, normal desktop). It asks twice and needs administrator approval. Only use it if DIY Engineering support asks you to.

About & support

Your ARCadeOS version and cabinet name; Run diagnostics; the opt-in Send health reports to DIY Engineering for support switch; buttons for the DIY Engineering Website, YouTube, Support page and this User manual; and the legal and data-source notices. See section 11.

8Cabinet hardware

Beyond the joystick and buttons, the ARCade has a servo-switched joystick restrictor, a spinner, a precision plunger, a nudge sensor and a six-key Stream Deck. Their settings live in Settings → Controls → Cabinet hardware and → Stream Deck. They are set up at the factory; this section explains what each does and what you can change.

Joystick restrictor (4-way / 8-way)

Many classic games were built for a 4-way joystick that physically cannot move diagonally — Pac-Man is much easier to steer that way. Most later games want the full 8-way stick. The ARCade’s joystick has a small servo that switches its gate between the two, and ARCadeOS sets it automatically every time a game launches.

  • Which way each game uses is detected for MAME games when they are imported; everything else defaults to 8-way. To change one game, open Details → Edit art & details → Joystick. The details screen shows the current value (“Joystick: 4-way”).
  • To switch by hand, press the 4/8 Way key on the Stream Deck (on the Tools page, and on the page shown during a game). It also remembers the new setting for the running game.
  • To turn the feature off, untick Joystick restrictor in Settings → Controls → Cabinet hardware.
Cabinet hardware with the restrictor values open
Cabinet hardware, with the restrictor’s value panel open.

ARCadeOS tells the controller which gate it wants with a short, specific rumble command (it never vibrates anything). The folded Command values panel under the restrictor (called Servo positions in versions before 1.28.96) holds the four values for that message: 4-way left / right (200 / 50) and 8-way left / right (50 / 200). They are not servo positions, and they must match the XInput Rumble Command Signatures in the controller’s Rumble Restrictor add-on (section 9). Leave them alone unless you have changed them there.

Spinner & trackball

SettingWhat it does
Spinner (rotary encoder)The 360-step spinner, read by the controller board and sent to Windows as a fast-reacting stick axis. With this ticked, MAME uses that axis for Dial and Paddle games (Tempest, Arkanoid, Tron). Axis must match the axis set in the controller (RX by default). If games turn the wrong way, swap Pin A and Pin B in the controller’s Rotary Encoders add-on. Fine-tune the feel in the firmware (section 9) and in MAME’s own Analog Input Adjustments menu.
TrackballFor a USB trackball, if one is fitted. It is a separate USB device, not part of the controller board. Turns on MAME’s mouse input; Device picks which mouse is the trackball if there is more than one.

Nudge sensor

The ARCade’s nudge sensor is a small motion sensor with its own round display, fixed inside the cabinet and connected over USB. When you shove the cabinet during a pinball game, it tells the table which way and how hard — just like nudging a real machine.

SettingWhat it does
Nudge sensorTurns the sensor on. The line below says whether it is connected. Restart ARCadeOS after turning it on.
Visual Pinball reads nudge directly (analog)Visual Pinball takes the sensor’s motion directly, so nudges are as strong as your shove. Future Pinball and Pinball FX always receive nudge keys.
Full scale (Visual Pinball)How hard a shove counts as a full-strength nudge. Lower = more sensitive.
Sensitivity (Future Pinball, Pinball FX)Scales the thresholds at which a shove sends a nudge key.
MountingThe angle the sensor is mounted at, so “left” means left.
Calibrate & test…Opens the live view below.
The Nudge sensor calibration card
Calibrate & test. Shove the cabinet: the dot follows it, and the meters show which thresholds a shove crossed.

In Calibrate & test: keep the cabinet still and press Calibrate so a resting cabinet reads as zero (it cancels the sensor’s mounting angle and any slope in your floor). Per-direction thresholds sets how hard a shove must be in each direction, the dead zone, smoothing and key hold time. Sensor screen controls what the sensor’s own display shows (and whether a bump on the cabinet wakes it from attract mode). Tilt warning tracks repeated hard shoves like a real machine’s tilt bob. Reset thresholds returns to the defaults; Update firmware updates the sensor itself.

Stream Deck

The six-key Stream Deck on the control panel is a shortcut panel for the cabinet. Its keys change page as you use them; the last key on each page is Back.

PageKeys
HomeGame · Favorites · Music · System · Tools · Help
GamePlay · Details · Favorite · Playtime · Delete · Back
FavoritesFavorites · Recent · Most Played · Pinball · Arcade · Back (jump straight to a tab)
MusicPrevious · Next · Play/Pause · Volume + · Volume − · Back
SystemShutdown · Restart · Sleep · Exit Game · Windows · Back
ToolsSettings · Import · 4/8 Way · Update · Library · Back
HelpGame · System · Music · Favorites · Tools · Back — each shows a card on the main screen explaining that page; press the same key again to close it.
In a gameShown automatically while a game runs: Previous · Next · Play/Pause · Mute · 4/8 Way · Exit Game

Its settings: Enable Stream Deck module; Brightness; Mounted upside-down (rotate 180°); Show game art while a game is running with Artwork mode (Stretch, Fill, Fit) and If art is missing (Game Title Card, Platform Card, ARCadeOS Card); Return to the controls page after launching; Return to the home page when idle with an Idle timeout; and a Splash logo.

9GP2040-CE controller setup

The joystick, buttons, spinner and plunger on your control panel are all wired to one controller board running GP2040-CE, open-source controller firmware, in an ARCade build made by DIY Engineering. This section explains how it is set up for the ARCade and how to change it safely.

Do you need this section?

Probably not. The controller is configured at the factory and ARCadeOS is set up to match it. Read on if you are curious, if you are replacing or adding hardware, if DIY Engineering support has asked you to check something, or if the joystick restrictor or spinner needs adjusting.

What the board does

The board reads every switch, the spinner and the plunger, and presents them to Windows as a single Xbox 360 controller (GP2040-CE’s XInput mode). That one choice is why everything just works: Windows, ARCadeOS, MAME, RetroArch and the pinball programs all understand an Xbox controller with no drivers, it is read every millisecond, and it is the only mode that can receive the command that moves the joystick restrictor.

The ARCade build of GP2040-CE adds the following to the standard firmware:

  • Rumble Restrictor add-on — drives the 4-way / 8-way servo when ARCadeOS asks.
  • Spinner velocity modes for the rotary encoder, so the spinner behaves like an arcade dial.
  • ARCade display layouts (Curvecade Left / Right) for the controller’s small screen, showing the spinner and plunger.
  • LED animation settings, and the ability for one action to light several buttons.
  • Reliability: settings stored in two copies, safer reboots mid-game, and Restart diagnostics on the configurator’s home page.
  • Safer boot combos: start-up button combinations only count on a real power-on and must be held for 2 seconds, so holding Start + Back to quit a game can never send the board into a setup mode.

How the panel is mapped

GP2040-CE names its inputs B1–B4, L1/R1, L2/R2, S1/S2 and so on. The table shows what each becomes in Windows and how ARCadeOS and your games use it with the cabinet’s default maps.

GP2040-CEXbox (XInput)In ARCadeOS menusArcade gamesPinball
Up / Down / Left / RightD-padMoveJoystickNudge (Left / Right / Up)
B1ALaunch / SelectButton 4—
B2BBackButton 5—
B3XFavouriteButton 1—
B4YDetailsButton 2—
R1RBNext tabButton 3—
L1LBPrevious tabButton 6—
R2RTNext song—Right flipper
L2LTPrevious song—Left flipper
S1BackMuteInsert coinExit (with Start)
S2StartSettingsStart gameExit (with Back)
L3 / R3Stick clicks——Left / Right MagnaSave
PlungerLeft stick, vertical——Plunger (pull = down)
SpinnerRight stick, horizontal (RX)—Dial / paddle—
A1GuideNot used——

Holding S2 + S1 (Start + Back) quits any game. Which physical GPIO pin each button is wired to is shown on the configurator’s Pin Mapping page; it is set at the factory and only needs changing if you rewire a button. If a button does the wrong thing in ARCadeOS only, change the ARCadeOS map rather than the firmware.

Opening the web configurator

All of the controller’s settings are changed in its web configurator, a small website the board serves over its own USB cable. While it is open the board is not a controller, so you will need a USB keyboard and mouse plugged into the cabinet (or move the controller’s USB cable to a laptop).

  1. In ARCadeOS, choose Settings → System → Exit ARCadeOS to get to the Windows desktop.
  2. Put the board into web-config mode, either way:
    • At power-on: hold Start (S2) and keep holding it for 2 seconds while the cabinet (or just the controller’s USB cable) is powered on.
    • While running: hold Start + X + Y (S2 + B3 + B4) for 4 seconds.
  3. Windows sees a new network adapter. Open a web browser and go to http://192.168.7.1.
  4. When you are finished, choose Reboot → Controller in the configurator’s top bar. The board becomes a controller again, then restart the cabinet (Restart from the Windows Start menu, or power it off and on) to return to ARCadeOS.
The configurator's Reboot dialog
Reboot in the top bar: Controller returns to normal; Web-config reopens the configurator; USB (BOOTSEL) is for firmware updates.
Every page has its own Save

Nothing changes until you press Save on that page. Before changing anything, make a backup (below) so you can always get back to the factory setup.

Recommended settings

These are the values the ARCade relies on. If something isn’t working, check them first, under Settings in the configurator’s top bar.

Input Mode Settings
Input Mode Settings — XInput.
Gamepad Settings
Gamepad Settings.
SettingARCade valueWhy
Current Input ModeXInputRequired. ARCadeOS, the emulators and the joystick restrictor all depend on it. Any other mode and the restrictor stops working.
Input Mode Controller TypeGamepadStandard controller.
D-Pad ModeD-PadThe joystick is read as a d-pad, which is what ARCadeOS, MAME and the pinball nudge keys expect.
4-Way Joystick ModeOffThe ARCade switches 4-way mechanically with the restrictor servo, so a software 4-way filter isn’t needed.
SOCD Cleaning ModeNeutralWhat happens if opposite directions are pressed at once. Neutral is the safe default.
Forced Setup ModeOffLeaves web-config and mode switching available.
Debounce Delay5 msFilters switch bounce without adding noticeable lag.
Boot Input ModesLeave as isHolding a button at power-on can start the board in another mode (e.g. Switch or PS4). If the cabinet ever stops responding after a power-on with a button held, power off and on again without touching anything.

Hotkeys

GP2040-CE has built-in hotkeys — button combinations that change controller settings on the fly. Several start with S1 + S2, which is the same pair as the ARCade’s exit buttons: for example S1 + S2 + Left switches the joystick to act as an analog stick. So when quitting a game, let go of the joystick while you hold Start + Back.

Hotkey Settings
Hotkey Settings. The Enabled switch at the bottom turns hotkeys off altogether.

If a hotkey ever triggers by accident (the stick starts behaving strangely in menus), restart the cabinet — or, to stop it happening, switch hotkeys off with the Enabled switch at the bottom of Hotkey Settings and press Save. With hotkeys off, the power-on combinations above still work.

Pin mapping, display and lighting

GPIO Pin Mapping page
Configuration → Pin Mapping. Example values shown — your cabinet’s pins are set at the factory. Don’t copy these numbers.
  • Pin Mapping assigns each GPIO pin to a button. Only change it if you have rewired something.
  • Display Configuration → Button Layout: Curvecade Left and Curvecade Right are the ARCade layouts for the controller’s small screen.
  • LED Configuration controls the button lighting: colours, animation effect, brightness, the colour a button flashes when pressed, and Turn Off When Suspended. The cabinet’s ambient lighting is separate and isn’t set here.

Rumble Restrictor add-on

This is the firmware half of the joystick restrictor. ARCadeOS sends a short “rumble” command with two specific motor values; the add-on recognises the pattern and moves the servo to the matching gate. Find it under Configuration → Add-Ons → Rumble Restrictor.

Rumble Restrictor add-on settings
Rumble Restrictor, with its default values. Your cabinet’s servo pin is set at the factory.
FieldDefaultMeaning
General
Servo Signal Pin−1The GPIO the servo’s signal wire is connected to. The add-on does nothing until this is set.
Servo Power Enable Pin−1 (unused)Optional pin that switches servo power on only while it moves.
Startup & default position
Startup BehaviorMove to Default StateWhere the servo goes at power-on: Move to Default State, Restore Last State, Wait for Host Command, or Move to Neutral.
Default State4-WayThe start-up gate, and the fallback for Restore Last State.
Servo positions (microseconds)
4-Way / 8-Way Position1000 / 2000The servo pulse for each gate. Set these with Calibrate Servo….
Neutral, Minimum, Maximum Position1500 / 1000 / 2000Middle position and the safe travel limits.
Reverse Servo DirectionOffTurn on if 4-way and 8-way come out swapped.
Movement & timing
Movement Duration / Settle Delay400 / 150 msHow long a move takes and how long to wait for it to settle.
Hold ModeRelease PWM After MovementWhether the servo is held after moving. Releasing (or cutting power) stops it buzzing.
Startup Movement Delay500 msWait after power-on before the first move.
Transition Cooldown / Maximum Active Time300 / 2000 msMinimum gap between moves, and a safety cut-off for a single move.
XInput rumble command signatures
4-Way Left / Right Rumble Value200 / 50The command that means “go 4-way”.
8-Way Left / Right Rumble Value50 / 200The command that means “go 8-way”.
Command Match Tolerance8How close the received values must be.
Command Minimum Duration / Lockout250 / 500 msHow long a command must be held to count, and how long new commands are ignored after a move.
Keep the two ends in step

The four Rumble Value numbers must match the values in ARCadeOS’s Settings → Controls → Cabinet hardware → Joystick restrictor panel. If you change one side, change the other. ARCadeOS always holds a command for 350 ms and waits at least 1.2 seconds between different gates, which suits the default timings — don’t lengthen the firmware’s timings much beyond them.

Calibrating the servo

  1. With a Servo Signal Pin set, press Calibrate Servo….
  2. Press Move to 4-Way. Use the − / + buttons (10 µs steps) until the gate sits cleanly in its 4-way position, then Save as 4-Way.
  3. Do the same with Move to 8-Way and Save as 8-Way.
  4. Close the dialog (this cuts servo power), then press Save on the add-on page.

Testing it

  1. Reboot the board to Controller and start ARCadeOS.
  2. Launch a 4-way game such as Pac-Man — the gate should click over as the game starts. Quit, and launch an 8-way game; it should switch back.
  3. Or press 4/8 Way on the Stream Deck’s Tools page to toggle it by hand.

Two moves in quick succession: the second is ignored if it arrives within about a second of the first. That is deliberate, to protect the servo — wait a moment and try again.

Spinner & plunger

The spinner uses the Rotary Encoders add-on (Configuration → Add-Ons). The ARCade build adds the Velocity control modes, which report how fast the spinner is turning and re-centre when it stops — the behaviour arcade dial games expect.

Rotary Encoders add-on configured for the spinner
Rotary Encoders, set up for a 360-step optical spinner. Pins are left blank here — yours are set at the factory.
FieldFor the ARCade spinnerMeaning
Pin A/CLK, Pin B/DTAs wiredThe spinner’s two signal pins.
Encoder TypeOptical / ContinuousThe spinner has no detents.
Pulses/Revolution (PPR)360In velocity mode this only scales the dial animation on the controller’s screen.
Counts per Step1Every edge counts — highest resolution.
Control ModeRight Analog X — VelocitySends speed on the right stick’s X axis. Must match the Axis (RX) in ARCadeOS’s Spinner setting.
Velocity Full Scale200 (adjust to taste)The spin speed that counts as full deflection. Lower = more sensitive.

Tune the spinner in two places: Velocity Full Scale here sets the overall range, and MAME’s in-game menu (Analog Input Adjustments) sets per-game sensitivity.

The plunger reaches Windows as the controller’s left stick, vertical axis, with the rest position at the top and a full pull at the bottom. Visual Pinball reads it directly as an analog plunger; for Future Pinball, ARCadeOS turns a pull into the plunger key. If a pull works the wrong way round, the analog stick’s Invert option is in the Analog add-on (Configuration → Add-Ons).

Backup & restore

Before you change anything, save a copy of the controller’s setup: Configuration → Data Backup and Restoration.

Data Backup and Restoration page
Data Backup and Restoration. Export Add-Ons Options includes the Rumble Restrictor and spinner settings.
  • Backup To File: leave every box ticked and press Save. Keep the file somewhere safe, such as a USB stick.
  • Restore From File: choose the sections to restore, press Load, pick your backup file, and then reboot to Controller.

Updating firmware

ARCadeOS updates the controller for you. Each ARCadeOS update carries the matching controller firmware. When a newer one arrives, a short notice says so after startup. Go to Settings → Controls → Controller firmware, which shows the version the board runs, and press Update controller. ARCadeOS restarts the board into update mode, copies the firmware and checks the new version. The controls stop working for about 15 seconds. Your controller settings are kept.

From 0.8.51 the version is also drawn, very small, in the bottom-right corner of the controller's screen. If ARCadeOS can't read the version, Settings says so and doesn't ask you to update; Update controller is still there, for when the controller's screen shows an older version. On firmware older than 0.8.50, ARCadeOS can't switch the board into update mode itself, so it asks you to hold Back + X + Y (S1 + B3 + B4) for 4 seconds, then does the rest.

To update by hand instead, use only the ARCade build (a file named like GP2040-CE_0.8.51_Pico_DIY.uf2, attached to each ARCadeOS release): the standard GP2040-CE download does not contain the Rumble Restrictor or the spinner velocity modes. Make a backup first.

  1. Put the board into USB (BOOTSEL) mode, any of these ways:
    • in the web configurator, Reboot → USB (BOOTSEL);
    • at power-on, hold Back + Start + Up (S1 + S2 + Up) for 2 seconds;
    • while running, hold Back + X + Y (S1 + B3 + B4) for 4 seconds.
  2. A drive called RPI-RP2 appears in Windows. Copy the .uf2 file onto it.
  3. The board restarts by itself as a controller with the new firmware. Check the version on the configurator’s home page.

The nudge sensor is a separate device with its own firmware; update it from ARCadeOS with Calibrate & test… → Update firmware.

Controller troubleshooting

What you seeWhat to do
No controls work at allThe board may be in web-config or BOOTSEL mode, or started in another input mode because a button was held at power-on. Power the cabinet off and on without touching the panel.
The joystick restrictor never movesCheck, in order: Joystick restrictor is ticked in ARCadeOS; the board is in XInput mode; the Rumble Restrictor add-on is Enabled with a Servo Signal Pin set; and the four rumble values match on both sides.
4-way and 8-way are swappedTurn on Reverse Servo Direction, or re-calibrate the two positions.
The servo buzzes or jittersSet Hold Mode to Release PWM After Movement or Disable Servo Power After Movement.
A plain controller buzzes when a game startsThat is the restrictor command on a controller without a restrictor. Untick Joystick restrictor in ARCadeOS.
The stick suddenly acts like an analog stickA hotkey was triggered while holding Start + Back. Restart the cabinet; see Hotkeys.
Spinner too fast or too slowAdjust Velocity Full Scale (lower = more sensitive), then fine-tune in MAME’s Analog Input Adjustments.
Spinner does nothing in MAMEThe control mode’s axis (Right Analog X) must match the Spinner Axis (RX) in ARCadeOS, and the Spinner box must be ticked.
Plunger works backwardsToggle the stick’s Invert option in the Analog add-on.
Settings didn’t stickPress Save on each page before rebooting. The home page’s Restart Diagnostics shows if the last save was cut short.

10Staying up to date

ARCadeOS updates itself. New features and fixes arrive over a secure, signed update feed, and there is nothing for you to download or install by hand.

The Updates settings section
Settings → Updates, with Release channel open.

Three switches control the whole thing, and all three are on by default:

  • Check for updates when ARCadeOS starts
  • Download updates in the background while idle — so the wait is already over by the time you are offered it
  • Install downloaded updates when I exit

You can also check whenever you like with Check for updates. When an update is found you can Download it, Install now, or Install on exit. Installing shows a real progress bar, measured against the actual download rather than a guess, and the cabinet restarts into the new version. When an update is ready on its own, ARCadeOS offers Install & Restart or Later.

Never mid-game

Updates never install while a game, an import or controller setup is running. The cabinet waits until you are done.

Release channel (folded) is set to Stable, which is what you want. Beta and Dev get new builds sooner but are less tested, and exist mainly for DIY Engineering’s own testing.

Nothing is lost

Updates replace the ARCadeOS software only. Your games, artwork, favourites, play history and settings are untouched.

11Care & troubleshooting

Diagnostics & one-tap repair

Settings → About & support → Run diagnostics checks the whole cabinet: ARCade Share, updates, each emulator, pinball components, RetroArch cores, artwork keys and free disk space. Each line gets a tick, a warning or a problem, with a plain-English explanation.

Cabinet diagnostics report
Cabinet diagnostics.
The About and support settings section
Settings → About & support.

Most problems can be fixed from the same card with Fix N issues — ARCadeOS reinstalls a missing emulator or core for you. Re-run checks again. If something needs a human, use Copy report or Save report: that produces a complete support packet you can paste into an email to us, and Contact support opens our support page.

Sending health reports

On the same screen you can opt in to Send health reports to DIY Engineering for support. It is off by default. When on, your cabinet periodically sends only: its name, ARCadeOS version, how many games it shares, the pass / warning / problem counts from the check above with a short description of each, free disk space, and whether ARCade Share is connected. No file paths, no keys, no game titles, nothing personal — and it goes only to DIY Engineering, never to other cabinets. It lets us spot a problem on your cabinet before you have to tell us about it.

Backups

Settings → System → Backup → Export… saves your settings, favourites, play history and per-game edits to a single .zip file. Worth doing before any big change, and worth keeping a copy on a USB stick. The controller board has its own backup — see section 9.

Common problems

What you seeWhat to do
A game will not start Run Check systems readiness (Settings → Games & library). It names what is missing and usually installs it for you.
A game has the wrong artwork Open the game’s details, choose Edit art & details, and use Find or Set…. Common with games that had several regional releases.
Lots of games have poor artwork Add the free artwork keys, then run Update all artwork.
New games did not appear Re-run the importer on the folder. Scanning twice is harmless — anything already in your library is skipped.
A game is in the wrong genre Edit art & details → Genre.
The joystick goes diagonal in Pac-Man Set the game to 4-way in Edit art & details → Joystick; see Joystick restrictor.
No sound Check you are not muted (press Back; a speaker icon shows while muted), then the volumes in Settings → Sound.
No internet Settings → Network & sharing → Wi-Fi. If the saved password stopped working, ARCadeOS asks you to type it again.
The screen is the wrong way round Settings → Display → Screen, choose the right orientation, and Apply now.
ARCade Share says
“Connecting…”
Give it a couple of minutes on first use. If it stays there, your network may be blocking Tor — open Network blocking Tor? (bridges) in the ARCade Share panel and tick Always use bridges.
ARCade Share shows
no other cabinets
Normal unless another cabinet is switched on and sharing at the same time. Cabinets appear within a few minutes of coming online.
Pinball nudging doesn’t work Check Nudge sensor says it is connected (Settings → Controls → Cabinet hardware), then use Calibrate & test….
Controls don’t respond See Controller troubleshooting.
The cabinet feels sluggish Run Run diagnostics and check free disk space — a nearly full drive is the usual cause.
Something else Run diagnostics, use Copy report, and send it to support@diy.engineering.

12Support & contact

Your ARCade cabinet is handcrafted by DIY Engineering in Winter Garden, Florida, and backed by a twelve-month warranty. If something is not right, talk to us.

Email support

support@diy.engineering

Attach a diagnostics report if you can — it tells us almost everything we need.

Cabinet & support pages

www.diy.engineering/arcade

Specifications, guides and ordering.

DIY Engineering

www.diy.engineering

Custom product development and engineering, backed by 30+ years of experience.

Video guides

youtube.diy.engineering

Walkthroughs and build videos.

Release notes

arcadeos.updates.diy.engineering

What changed in each version of ARCadeOS.

This manual

arcadeos.updates.diy.engineering/manual.html

Always the current version. Use Print / Save PDF for a paper copy.

All of these links are also on your cabinet, in Settings → About & support.

13Quick reference

Worth printing on its own and keeping near the cabinet.

To do thisPress this
Start the highlighted gameA, then A on Play
Go backB
Favourite a gameX
See a game’s detailsY
Open SettingsStart
Open HelpHelp button on screen
Next / previous categoryRB / LB
Next / previous music trackRT / LT
Mute everythingBack
Jump to a letterPush left from the first column, then up/down
Type textA on a text box opens the keyboard
Insert coin / start (in a game)Back / Start
Quit a running gameHold Start + Back
Shut downHold Start + Back on the main screen, or Settings → System
Switch joystick 4-way / 8-way4/8 Way on the Stream Deck
Add gamesPlug in a USB drive, or Settings → Games & library
Connect to Wi-FiSettings → Network & sharing → Wi-Fi
Fix a problemSettings → About & support → Run diagnostics
Controller web configuratorHold Start 2 s at power-on, then http://192.168.7.1