FOR ATGAMES LEGENDS PINBALL 4KP & HDP

Retro Launcher

A neon front-end for 21 retro systems that runs right on your pinball cabinet. Browse on the playfield, play on the backglass or playfield, and watch box art, marquees and controls light up the other screens.

Retro Launcher artwork: a pixel-art controller over the Retro Launcher logo and a neon grid

Built for the cabinet

An External Application: no firmware changes, no root. Copy it to a USB stick and it shows up in the cabinet's own menu.

▶

Pick your screen

Every game plays on the backglass or the playfield, per game or for a whole system. Vertical arcade games go to the playfield by themselves.

★

Every screen lit

Box art on the backglass, the game's logo on the DMD like a marquee, and the controls on the playfield while you play.

↓

Artwork in one press

Settings > Download artwork fetches covers, logos and bezels for the games you have, and nothing else.

⇄

Network transfer

Send games from any computer or phone on your network straight to the cabinet. No more pulling the USB stick.

◉

Arcade that just works

Each arcade zip is checked against FBNeo and MAME 2003-Plus and played with the emulator it's complete for, sorted into genres.

❖

Save anywhere

Save states, an automatic resume point when you quit, disc swapping, core options and high scores.

⚙

Your buttons

Presets or press-to-assign button mapping, for one game or a whole system.

✓

BIOS check

Lists which BIOS files your systems can use, whether yours are good dumps, and exactly where each one goes.

↻

Updates itself

Checks every time it starts, shows what's new, and installs a new release in place, replacing only the files that changed.

▦

Two looks

Neon, or Attract: an arcade attract-mode style with pixel type, square boxes and CRT scanlines, on every screen.

☯

Bring a friend

Up to four players: each USB or Bluetooth controller joins as the next player, alongside the cabinet's own controls.

⟳

Sideways games, upright

Rotate picture turns a game that comes up sideways, and the joystick turns with it. Remembered per game.

21 systems

Emulators built for the cabinet's chip, including GPU-accelerated Dreamcast, N64, Saturn and PSP.

ARCADE

  • Arcade FBNeo / MAME 2003-Plus
  • Neo Geo FBNeo
  • NAOMI Flycast
  • Atomiswave Flycast

CONSOLES

  • NES FCEUmm
  • Super Nintendo Snes9x
  • Nintendo 64 Mupen64Plus-Next
  • Genesis / Mega Drive Genesis Plus GX
  • Master System Genesis Plus GX
  • Saturn YabaSanshiro
  • Dreamcast Flycast
  • PlayStation PCSX ReARMed
  • PC Engine / TurboGrafx-16 Beetle PCE Fast
  • Atari 2600 Stella
  • ColecoVision Built-in / Gearcoleco

HANDHELDS

  • Game Boy Gambatte
  • Game Boy Color Gambatte
  • Game Boy Advance gpSP
  • Game Gear Genesis Plus GX
  • Atari Lynx Handy
  • PSP PPSSPP

Three screens, one game

Retro Launcher drives every display in the cabinet at once.

Retro Launcher on a cabinet: the Consoles list on the playfield with Arcade highlighted, the system's name and game count on one side, and its arcade-cabinet art over a neon sunset on the other
The same Consoles screen in the Attract theme: pixel type, square boxes with hard shadows, and Arcade highlighted in red with a yellow shadow
The Attract theme (Settings > Theme)
PlayfieldThe menu while you browse. While you play: the game's cover, its controls and how to exit, or the game itself.
BackglassThe highlighted game's box art while you browse, then the game, framed by a bezel or a soft glow.
DMDThe game's logo like an arcade marquee, the console's picture, or the menu's own icons.

Get started

  1. Download the latest release zip and unzip it. You get an external folder.
  2. Copy the external folder to the root of your cabinet's USB stick (merge it with one that's already there).
  3. Start Retro Launcher from the cabinet's External Applications menu. It creates a folder for each system's games.
  4. Add your games to external/retro-launcher/roms/<system>/, from a computer or with Settings > Network transfer, then run Settings > Download artwork.

Retro Launcher ships no games, no BIOS files and no copyrighted artwork. Use it with games you own. Settings > BIOS check tells you which BIOS files your systems can use and where to put your own.

Questions & help

The basics. The guides go into more detail: installing, adding games, every system, the arcade guide, controls & settings and troubleshooting.

GETTING STARTED

Which cabinets does it work on?

AtGames Legends Pinball 4KP and HDP.

Do I need the Arcade Control Panel to use this?

I mean, you can try to play without an Arcade Control Panel, but only a small number of games will work as intended. It was totally meant to be used with an Arcade Control Panel.

Do I have to modify my cabinet?

No. Retro Launcher is an External Application that runs from the USB stick: no firmware changes, no root. Take the stick out and the cabinet is exactly as it was.

Where do my games go?

In external/retro-launcher/roms/<system>/ on the USB stick.

  • Zips are fine for most systems. Arcade zips go in as they are (don't unzip them).
  • Disc games work best as .chd. A .cue with its tracks, or one folder per game, works too.
  • Each system's folder has a README listing the file types it takes.
  • The folders appear after Retro Launcher's first run (see the next question).
I don't see a roms folder (or the folder for my system).

Retro Launcher makes the folders itself the first time it runs. Start it once from the cabinet's External Applications menu, then put the USB stick back in your computer. You'll find roms/, saves/ and system/, with a folder for every system, each with a README listing the file types it takes.

You can also make a missing folder yourself. It just needs the system's exact folder name, for example roms/snes, roms/psx or roms/neogeo. The README lists every one.

My game has several discs. How do I play it?

For PlayStation and Dreamcast, put the discs in the system's folder, named the usual way, for example Final Fantasy VII (USA) (Disc 1).chd, (Disc 2) and (Disc 3). A folder per disc works too (Final Fantasy VII (USA) (Disc 1)/...), and so do those disc folders inside one folder for the game. Retro Launcher spots them and lists them as one game, with one memory card for your saves. When the game asks for the next disc, open the pause menu and choose Change disc.

  • The discs must not be zipped: unzip them, or better, convert each to .chd.
  • Behind the scenes it writes a small playlist (Final Fantasy VII (USA).m3u) next to the discs. You can also write one yourself, listing the disc files one per line.
  • Already played disc by disc on an older version? Your in-game saves (the memory card) carry over. Save states and the quit-and-resume point don't, because they hold a specific disc in the drive, so save in-game at a save point before updating.
  • Saturn's emulator can't swap discs, so a Saturn multi-disc game shows each disc as its own game.
Can I use my CoinOps X files?

Not the .uce files. CoinOps X games come packed as .uce images that the cabinet's own launcher opens, and Retro Launcher doesn't read them. It plays ordinary game files from its roms/ folders. Both can live on the same USB stick.

If you have the games themselves as files, copy them into external/retro-launcher/roms/<system>/: arcade .zip sets into roms/arcade/ as they are, console games into their system's folder. Arcade zips are checked against FBNeo and MAME 2003-Plus; a set made for a different MAME version may show as incomplete. Their videos and artwork aren't used; Settings > Download artwork fetches box art, logos and bezels instead.

Some sounds are missing in Donkey Kong (or another old arcade game)

That game needs its sound samples, a separate zip with the game's name. Put it in external/retro-launcher/system/fbneo/samples/ and in external/retro-launcher/system/mame2003-plus/samples/ (create the folders), so either emulator finds it. More

Does it come with games or BIOS files?

No, never. Settings > BIOS check lists the BIOS files your systems can use, whether each is required or good to have, and the folder to put your own copy in.

How do I get box art, logos and bezels?

Settings > Download artwork, with the cabinet connected to the internet. It only fetches artwork for the games you have.

Can I add games without taking out the USB stick?

Yes: Settings > Network transfer. The cabinet shows an address and a PIN. Open the address in a browser on any computer or phone on your network and drop your games in.

PLAYING

How do I pause, save or quit a game?

Hold Start for a second, or press Home, for the pause menu: save and load state, reset, core options, rotate picture, swap players, change disc and quit. Quitting also saves a resume point, offered the next time you start the game.

Can I play on the playfield instead of the backglass?

Yes. For one game, press Home on it and change Screen. For everything, use Settings > Default game screen. Vertical arcade games go to the playfield by themselves.

Can two people play?

Yes. Connect a USB or Bluetooth controller: the cabinet is player 1 and each controller joins as the next player, up to four. To play alone on a controller, turn on Swap players 1 and 2 in the pause menu. On an Xbox controller, View is Coin and Menu is Start.

Can I change how it looks?

Yes: Settings > Theme, Neon or Attract. The menu restarts in the new look.

How do I change the buttons?

Press Home on a game and choose Controls. Pick a preset, or select a button and press the cabinet button you want for it, for that game or the whole system.

ColecoVision asks me to pick a game number.

Auto-start picks it for you: keypad 1, unless you change it with Home > Start with. In a game, Start is keypad 1, Rewind is *, and Y opens the on-screen keypad for the rest.

What does Settings > Screen artwork do?

It turns the extra screens on or off: the ones not showing the menu or the game. When it's On (the default):

  • While you browse, the backglass shows the highlighted game's box art, and the DMD shows the game's logo like a marquee, the console's picture or the menu's icons.
  • While you play, the free screens show the game's cover and controls on the playfield, its box art on the backglass, and its logo or the console on the DMD.

Off leaves those screens alone, so only the screen with the menu or the game is used. The change applies from the next game you start, and to the menu the next time Retro Launcher starts.

Where are my saves?

In external/retro-launcher/saves/<system>/, together with the save states.

TROUBLESHOOTING

An arcade game is dimmed or won't start.

The note under the game says why. Usually it's a missing BIOS or parent zip (such as neogeo.zip), or ROMs from a different version:

  • FBNeo wants current FBNeo sets.
  • MAME 2003-Plus wants MAME 0.78 sets.

Settings > BIOS check lists every zip your arcade games are missing.

A game runs slowly or the sound crackles.

Lower the resolution in the pause menu's Core options. PSP, Dreamcast and N64 render above their original resolution by default. Saturn already skips a frame when it falls behind, instead of cutting the sound.

How do I update?

Settings > Updates. Retro Launcher also checks every time it starts, and Update available stays on the Settings row until you install it. Before installing, it shows what's new. Updating never touches your games, saves, settings or artwork.

Something's wrong. How do I report it?

Open an issue on GitHub and attach external/retro-launcher/data/launcher.log from the USB stick. It records what happened.