FOR ATGAMES LEGENDS PINBALL 4KP & HDP

Jukebox

A music and internet-radio player for your pinball cabinet. Tune into thousands of radio stations, play your own music, videos and YouTube, and watch the album art (or the video) light up the backglass while a jukebox marquee glows on the DMD.

Download the latest release View on GitHub
Jukebox artwork: a glowing neon jukebox over purple palm leaves

See it play

Everything is built for the playfield screen and the cabinet's buttons, with a button legend along the bottom of every screen.

Main menu with the Now Playing card and Radio, Search, Favorites, My Music, Videos and YouTube tiles
The main menu
Now Playing with album art, progress bar and spectrum
Now Playing takes on the album's colors
Radio category list with the mini player
Browsing radio, with the mini player

Everything in one box

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

đŸ“ģ

Internet radio

Curated categories – Featured, Popular, Top Voted, SomaFM, and genres like Rock, Jazz, Lo-fi and Ambient – streamed live.

🔎

Search

Find any station by name with the on-screen keyboard.

❤ī¸

Favorites

Save stations with a flipper. They're kept between sessions and carry over between versions.

📁

Your own music

A music folder on the USB drive becomes a library by album and artist, with shuffle and auto-advance.

đŸ’ŋ

Now Playing

Album art over a blurred wash of itself, a progress bar, and a live spectrum analyzer. Radio gets a spinning record.

â–ļī¸

YouTube

Search YouTube or pick a music channel – Lofi Girl's 24/7 radios, NewRetroWave, NoCopyrightSounds, NPR Music – and it plays on the backglass, the thumbnail as the cover. New in 2.4.

đŸŽŦ

Videos on the backglass

A videos folder on the USB drive plays on the backglass, folder by folder, with Now Playing on the playfield.

✨

Every screen lit

The album cover big on the backglass, a lit jukebox marquee on the DMD, placed right on both the 4KP and HDP.

🎚ī¸

Plays everything

MP3, AAC, FLAC, OGG, Opus, WAV and WMA, with album art from the folder or embedded in MP3, FLAC and M4A files. Videos in MP4, MKV, MOV, WebM and AVI.

🕹ī¸

No extra controls needed

Everything works with the cabinet's own buttons and flippers. An Arcade Control Panel isn't required.

đŸŽļ

Music keeps going

Playback continues while you browse; the mini player on every list shows what's on.

đŸ“ļ

Add music and videos over Wi-Fi

Send songs, videos or whole album folders from a computer or phone on your network, without taking the USB drive out.

âŦ†ī¸

Updates itself

When a new version is out, a banner on the main menu installs it and restarts. Your favorites and music stay put.

Playing your music

Jukebox scans a folder named music at the root of the USB drive, and every folder inside it.

  1. On a computer, open the USB drive.
  2. Create a folder named music (all lowercase) at the drive's root.
  3. Copy your music into it. An Artist/Album/track layout works great.
  4. Plug the drive into the cabinet and open My Music: browse by Albums, Artists or All Tracks, or turn on Shuffle. Or skip the copying: Add music over Wi-Fi sends music from a browser.
USB DRIVE (root)
└── music/
    ├── Daft Punk/
    │   └── Discovery/
    │       ├── cover.jpg
    │       ├── 01 One More Time.mp3
    │       └── 02 Aerodynamic.mp3
    └── Bonobo/
        └── Migration/
            └── 01 Migration.flac

Album art comes from a cover, folder or front image in the album's folder, or a picture embedded in MP3, FLAC and M4A files. Names come from the files' tags, or from the folders when there are none.

Read the full Your music guide →

The controls

"Flipper" means either flipper button. The bottom of every screen shows the buttons that work there.

ScreenButtons
MenuArrows move · Start open · Back exit
RadioArrows select · Start open / play · Flipper favorite · Back up a level
SearchArrows move · Start press key · then Start play, Flipper favorite on results
FavoritesArrows select · Start play · Flipper remove · Back to menu
My MusicArrows select · Start open / play / toggle Shuffle · Back up a level
VideosArrows select · Start open a folder / play · Back up a folder
YouTubeArrows select · Start open a channel / play · Back up a level
Now Playing←/→ previous / next · Start pause · Flipper shuffle (your music) or favorite (radio) · Back back

Get started

  1. Download jukebox-app.zip from the latest release.
  2. Unzip it into a folder named jukebox-app inside the external folder on your cabinet's USB stick: external/jukebox-app/. From 2.2 on, Jukebox updates itself; for older versions, replace the old files. Your favorites carry over.
  3. Start Jukebox from the cabinet's External Applications menu.
  4. For your own music, add a music folder at the root of the USB drive (see above). Radio and Search need the cabinet online.

Questions & help

The basics. The README has the full details.

Which cabinets does it work on?

AtGames Legends Pinball 4KP and HDP. Jukebox reads the cabinet model to put the menu, the backglass art and the DMD marquee on the right screens.

Does it need the internet?

Radio, Search and YouTube do. My Music and Videos work offline.

Do I need the Arcade Control Panel?

No. Everything works with the cabinet's own buttons; a flipper saves favorites. Y and X still work if you have a panel.

It says "No music found".

Check that the folder is named exactly music (lowercase), sits at the root of the USB drive, and holds files of a supported type: MP3, M4A/AAC, FLAC, OGG, Opus, WAV or WMA. A large library shows "Scanning library…" briefly the first time. More in the Your music guide.

My album art doesn't show.

Put a cover.jpg (or folder / front, .jpg or .png) in the album's folder. Pictures embedded in MP3, FLAC and M4A files are read too, and when there's neither, Jukebox looks the album up online (the cabinet needs Wi-Fi). For an album the lookup can't find, a cover.jpg is the way.

A radio station won't play.

Stations come and go, so it may simply be offline right now. Try another one.

Something's not working. How do I send a log?

Jukebox can write a log of what it's doing, which is usually enough to find the problem: a screen showing the wrong thing, a YouTube video or cover that won't load, the backglass not changing, and so on.

  1. On a computer, create a plain text file named jukebox.cfg at the root of the USB stick (next to the external folder).
  2. Put this one line in it: diag = 1
  3. Plug the stick back in, open Jukebox and do whatever goes wrong.
  4. Close Jukebox and copy jukebox-panels.log from the root of the stick.

Open an issue, describe what you did and what you saw, and attach the log. While diag is on, Jukebox also labels each screen with which panel it is; delete jukebox.cfg (or set diag = 0) when you're done.

How does YouTube work?

Choose YouTube on the main menu: Search YouTube, or pick Lofi Girl (its 24/7 live radios), NewRetroWave, NoCopyrightSounds or NPR Music. The video plays on the backglass with Now Playing on the playfield, and the rest of the list follows. YouTube plays through yt-dlp, a free, public-domain tool that isn't part of Jukebox: the first time, Jukebox asks, downloads it from GitHub (about 3 MB) and keeps it updated weekly. It needs the internet. Jukebox isn't affiliated with YouTube or the channels it lists.

How do I play videos?

Make a folder named videos at the root of the USB drive, copy video files into it (sub-folders are fine), and choose Videos on the main menu, the strip under the tiles. The video plays on the backglass with Now Playing on the playfield, and the rest of the folder follows. H.264 up to 1080p at 30 fps plays best; 4K, 60 fps or HEVC files may stutter.

Can I add music or videos without taking the USB drive out?

Yes. In My Music, choose Add music and videos over Wi-Fi. The cabinet shows an address and a PIN: open the address in a browser on a computer or phone on the same network, enter the PIN, and drop in songs, videos or whole album folders. Videos go to the videos folder. Press Back on the cabinet when you're done. See the Your music guide.

How do I update Jukebox?

From version 2.2, Jukebox checks for a new version when it starts. When there is one, a banner appears under the main menu tiles: select it, choose Install, then Restart now. Only the app itself is replaced. On 2.1 or older, install 2.2 by hand once (see Get started).

Will an update keep my favorites?

Yes. Favorites are saved on the device and carry over when you replace the app with a new version.