Home

Welcome to the Phoniebox Wiki

Phoniebox is a contactless jukebox for the Raspberry Pi, playing audio files, playlists, podcasts, web streams and spotify triggered by RFID cards. All plug and play via USB, no soldering iron needed. Update: if you must, it now also features a howto for adding GPIO buttons controls.

On the right you see the list of available documentation.

If you want to help working on the wiki, you are more than welcome to do so 😄

All the best, Micz

Phoniebox Gallery

See innovation, upcycling and creativity in the Phoniebox Gallery

Notice

Caution

Do NOT use the latest RaspberryPi OS Bookworm release (also don't upgrade via apt) with the new kernel 6.6, if you need to use GPIO components . There have been incompatible changes for the RPi.GPIO library, so Buttons, Shims and Rfid Reader usage can be broken (#2295).

Using RaspberryPi OS Bullseye is the current recommendation as it does not use the new kernel.

Note

Currently Version 2 is the default for Phoniebox.

But Version 3 is becoming mature and will soon be the new default. Therefore Version 2 is slowly going into a maintenance mode and no new features will be added to this version.

Important

The Phoniebox software V2.x wiki pages have been mostly created for buster or earlier. As this should not be a problem in general, some instructions may not work out of the box on newer Raspberry Pi OS versions. If you encounter problems please head to the issue or discussion section.