RPi-Jukebox-RFID

Phoniebox: the RPi-Jukebox-RFID

Introduction

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. It also features GPIO buttons control support.

Everyone builds an original

This is one of the most inspiring and gratifying experiences: Phoniebox is about Open Source AND Open Design.

See innovation, upcycling and creativity in the Phoniebox Gallery

Install Phoniebox

Version 3 is coming

The goal for Version 3 was to tidy up the codebase, focus on a single programming language for the core (Python), establish a solid plugin system and build a responsive web client. Read on here if you want to learn about more reasons.

Looking for adopters, testers and contributors

If you want to test or help develop this new version called future3, let us know what you think about the new architecture, the new web application and help us find bugs (or fix them proactively).

While Version 3 is still under development, it is becoming a lot more stable! Although not all of the features from version 2.x have been ported to version 3 so far.

If you seek the adventure, your support will be more then welcome. Before contributing, check out the following references.

• ⭐ Releases
• Install Jukebox Version 3
• Report a bug
• Propose a feature
• ☑️ Feature Status
• Documentation
• ‍ Development
• Code: Release Branch, Development Branch

---

Version 2

[!NOTE] Version 3 is becoming mature and will soon be the new default of Phoniebox. Therefore Version 2 is slowly going into a maintenance mode and no new features will be added to this version.

Check out the following references.

• ⭐ Releases
• Install Jukebox Version 2
• Report a bug
• ☑️ Features
• Documentation
• Code: Release Branch, Development Branch

Features Version 2

• The one-line install script handles both Classic and +Spotify when setting up your Phoniebox
  • integrated selection of RFID readers
  • features non-interactive installs based on a config file
• RFID control for playout and controlling your Phoniebox (e.g. set maximum volume with RFID cards).
• Support for various RFID readers, e.g.
  • USB
  • RC522
  • PN532
  • PC/SC
  • also multiple readers simultaneously
• GPIO control for buttons and much more to control your Phoniebox via GPIO.
• Control via smooth Web App running on ajax from your phone, tablet or PC. You can play, upload, move files, assign new RFID cards, control playout, settings, etc.
• Support for files with embedded chapters metadata (like m4a)
• Customizable poweroff command
• WiFi management
  • RFID cards to toggle WiFi (or switch it on/off)
  • Read out the WiFi IP address (if you are connecting to a new network and don't know where to point your browser)
  • Hotspot Phoniebox: ad-hoc hotspot if no known network found (IP: 10.0.0.5 SSID: phoniebox Password: PlayItLoud)
• Touchscreen LCD display Player (file: index-lcd.php in web app)
• Integrate your Phoniebox in your Smart Home with MQTT.
• Player control
  • Playout Resume switch for audio books, allowing you to jump straight back to where you were (unless you fell asleep...).
  • Playout Shuffle switch to mix up your playlists.
• Audio sources
  • Local audio files
  • Download from YouTube directly to your Phoniebox.
  • Support for Spotify integration.
  • Podcast feature for Phoniebox

Quick install Version 2

• Check Installation instructions with the One line install script for Raspberry Pi OS.
• Two editions:
  • Phoniebox Classic supports local audio, web radio, podcasts, YouTube (download and convert), GPIO and/or RFID
  • MUST READ for users of Phoniebox +Spotify Edition
• Once everything has been installed and configured, read the manual to change settings, register RFID cards, add audio.
• Adding push buttons to control volume, skipping tracks, pause, play: read the GPIO Control Readme.
• There's also a Complete Install Guide

Contact and Support

• Please ask general questions in Discussions
• Bugs and enhancements should still be in Issues.
• Want to discuss with others? Check out our Matrix community

Documentation

Documentation can be found in the GitHub wiki for Phoniebox. Please try to add content in the wiki regarding special hardware, software tweaks and the like.

Manual

In the Manual you will learn:

• How to connect to the Phoniebox from any computer to add and edit audio files.
• How to register new RFID cards, assign them a human readable shortcut and add audio files for each card.
• How to add webradio stations and other streams to the playout files - and even mix web based and local files.
• Adding Podcasts the your Phoniebox
• How to control the Phoniebox through the web app.
• How to assign cards specific tasks such as changing the volume level or shutting down the Phoniebox.

Troubleshooting

There is a growing section of troubleshooting including:

• I want to improve the onboard audio quality
• I am moving, how do I get the Phoniebox into my new WiFi network?
• The RFID Reader doesn't seem to work.
• Changing the volume does not work, but the playout works.
• Script daemon_rfid_reader.py only works via SSH not by RFID cards.
• Script daemon is closing down unexpectedly.
• Everything seems to work, but I hear nothing when swiping a card.
• I would like to use two cards / IDs to do the same thing.

Hardware aka Shopping List

Here is a list of equipment needed. You can find a lot second hand online (save money and the planet). The links below lead to Amazon, not at all because I want to support them, but because their PartnerNet program helps to support the Phoniebox maintenance (a little bit...).

[!NOTE] Depending on individual projects, the hardware requirements vary.

Raspberry Pi

• Raspberry Pi 4 Modell B
• Raspberry Pi 3 Model B
• Raspberry Pi Zero WH

You might be surprised how easy and affordable you can get an RPi second hand. Think about the planet before you buy a new one.

RFID Reader and cards / fobs

• RFID Card Reader (USB): Neuftech USB RFID Reader ID using 125 kHz - make sure to buy compatible cards, RFID stickers or key fobs working with the same frequency as the reader.
  • RFID cards: 125 KHz EM4100 make sure the frequency matches the RFID card reader!
  • RFID fobs / key rings: EM4100 RFID-Transponder-Schlüsselring, 125 KHz make sure the frequency matches the RFID card reader!
• RFID Kit RC522: RC522 Reader, Chip, Card for Raspberry Pi 13.56MHz
  • RFID sticker / tags: MIFARE RFID NFC Tags untested by me personally, but reported to work with work with RC522 and PN532 card readers.

Speakers / amps

• USB Stereo Speaker Set (6 Watt, 3,5mm jack, USB-powered) black | This USB powered speaker set sounds good for its size, is good value for money and keeps this RPi project clean and without the need of a soldering iron :)
• USB A Male to Female Extenstion Cable with Switch On/Off | I placed this USB extension between the USB power adapter and the Phoniebox. This will allow you to switch the Phoniebox on and off easily.
• USB 2.0 Hub 4-port bus powered USB Adapter | Depending on your setup, you will need none, one or two of these. If you are using the external USB powered speakers, you need one to make sure the speakers get enough power. If you want to use the additional USB soundcard and have an older RPi, you might need a second one to make sure you can connect enough devices with the RPi.

Arcade Buttons

• USB Interface for Arcade buttons if you insist on not soldering hardware.
• Arcade Buttons / Sensors (one of these might suit you)
  • Arcade Buttons / Schalter in various colours if you want buttons for the GPIO control.
  • [Arcade Buttons w