Skip to content

A Raspberry Pi jukebox, playing local music, podcasts and web radio, streams and spotify triggered by RFID cards and/or web app. All plug and play via USB. GPIO scripts available.

License

Notifications You must be signed in to change notification settings

Caliandroid/RPi-Jukebox-RFID

 
 

Repository files navigation

GitHub last commit (branch)

Python Tests Install Script Tests

Gitter chat

Phoniebox: the RPi-Jukebox-RFID

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.

The Phoniebox Calendar 2021 is here!!!

Another bunch of wonderful designs! 2021 is the third Phoniebox calendar. If you are interested, you can see the 2019 and 2020 calendars in the docs folder. Download the printable PDF of 2021 here.

The 2021 Phoniebox Calendar

The year 2020 also has a clear ⭐ community hero ⭐: @s-martin has been doing outstanding work for the Phoniebox community:sparkles:. Thanks to you and may 2021 be a wonderful year for you.

Important updates / news

  • Discussions forums we use Github's Discussions feature for a more forum style. Please ask general questions in Discussions, bugs and enhancements should still be in Issues.

  • Gitter Community we got ourselves a gitter community; chat us up at https://gitter.im/phoniebox

  • Phoniebox 2.2 released (2020-11-23)

The 2.2 release was pushed through the doors with many contributors (some of which in alphabetical order): @andreasbrett @BerniPi @juhrmann @Luegengladiator @MarkusProchaska @MarlonKrug @patrickweigelt @princemaxwell @RalfAlbers @s-martin @themorlan @veloxidSchweiz @xn--nding-jua. List of all contributors

What's new in version 2.2?

  • 🔥 Fixed location of gpio_settings.ini for GPIO control
  • Added support for files with embedded chapters metada (like m4a) enhancement
  • Added customizable poweroff command bash enhancement
  • Finally fixed resume function...
  • Lots of fixed bugs and minor improvements...
    • Status LED, Rotary Button, Volume Up/Down, custom music directory for +Spotify, Startup sound volume

What's still hot?

  • The constantly improved one-line install script handles both Classic and +Spotify when setting up your Phoniebox
    • integrated improved GPIO control
    • integrated selection of RFID readers and uses multiple readers simultaneously
    • features non-interactive installs based on a config file
  • 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.phpin web app)
  • Integrate your Phoniebox in your Smart Home.
  • Smoother Web App running on ajax.
  • New search form for local files
  • Control the debug logs in the web app (individual scripts switched on/off, empty log file).
  • Set maximum volume with RFID cards.
  • Control via wifi web app from your phone, tablet or PC. You can play, upload, move files, assign new RFID cards, control playout, settings, etc.
  • RFID control for playout and controlling your Phoniebox.
  • 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.
  • Download from YouTube directly to your Phoniebox.
  • Support for Spotify and Google Play Music integration.
  • Podcasts! More for myself than anybody else, I guess, I added the podcast feature for Phoniebox (2018-05-09)
  • Buttons and knobs / dials to control your Phoniebox via GPIO.

Quick install

One line install script for Raspbian buster available.

  • MUST READ for users of Phoniebox +Spotify Edition
  • This install script combines the two versions Classic and + Spotify.
  • Phoniebox Classic supports local audio, web radio, podcasts, YouTube (download and convert), GPIO and/or RFID

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.

The 2020 Phoniebox Calendar is out!

Celebrating all the great designs of 2019, I put together a calendar for 2020, see picture above. If you want to be featured on next years calendar, please make sure to add your Phoniebox pics to the design thread here on github.

The PDF is about 6MB and will print well on A2 paper size, but it should also look good on larger poster sizes. Thanks to all the contributors, designers and makers. Have a good start into 2020 and keep up the good work! The 2020 Phoniebox Calendar


If you like your Phoniebox, consider to buy me a coffee or donate via PayPal to micz.flor@web.de using the friends option.


Prototype of the RFID jukebox

See the Phoniebox code in action, watch this video and read the blog post from iphone-ticker.de

We love Tech published a video screencast on how to build your Phoniebox (in German), you can find all the steps and see the final product here:


Installation und Hardware

Web App and Audio / Spotify

The finished Phoniebox in action

A new video screencast about

What makes this Phoniebox easy to install and use:

  • Runs on all Raspberry Pi models (1, 2 and 3) and Raspberry Zero. (jump to the install instructions)
  • Just plug and play using USB, no soldering iron needed.
  • Once the Phoniebox is up and running, add music from any computer on your home network.
  • Register new RFID cards easily without having to connect to the RPi.
  • Play single or multiple files, podcasts or web streams.
  • Volume control is also done with RFID cards or key fobs.
  • Connect to your Phoniebox via your wifi network or run the Phoniebox like an access point and connect directly without a router.
  • Bonus: control the Phoniebox from your phone or computer via a web app.

The web app allows you to change the volume level, list and play audio files and folders, stop the player and shut down the RPi gracefully.

The web app runs on any device and is mobile optimised. It provides:

  • An audio player to pause, resume, shuffle, loop, stop and skip to previous and next track.
  • Sub folder support: manage your collection in sub folders. Phoniebox has two play buttons: only this folder and eeeeverything in this folder.
  • Manage files and folders via the web app.
  • Register new RFID cards, manage Phoniebox settings, display system info and edit the wifi connection.
  • Covers displayed in the web app (files called cover.jpg).

Phoniebox Gallery

Caption Caption Caption Caption Caption Caption

See more innovation, upcycling and creativity in the Phoniebox Gallery or visit and share the project's homepage at phoniebox.de. There is also an english Phoniebox page.

Installation

Adding push buttons to control volume, skipping tracks, pause, play: read the GPIO buttons installation guide.

Components

Special hardware is now organised in the folder components. If you have new hardware attached to your Phoniebox, please add to this library! It currently contains soundcards, displays, GPIO controls, RFID reader, smarthome integration.

Manual

In the Manual you will learn:

Contributing improvements

Read the CONTRIBUTING.md file for more infos on how to contribute code.

Reporting bugs

To make maintenance easier for everyone, please run the following script and post the results when reporting a bug. (Note: the results contain some personal information like IP or SSID. You might want to erase some of it before sharing with the bug report.)

/home/pi/RPi-Jukebox-RFID/scripts/helperscripts/Analytics_AfterInstallScript.sh 

Just copy this line and paste it into your terminal on the pi.

If you find something that doesn't work. And you tried and tried again, but it still doesn't work, please report your issue in the "issues" section. Make sure to include information about the system and hardware you are using, like:

Raspberry ZERO, OS Jessie, Card reader lists as (insert here) when running scripts/RegisterDevice.py, installed Phoniebox version 0.9.3 (or: using latest master branch).

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.

Acknowledgments

There are many, many, many inspiring suggestions and solutions on the web to bring together the idea of a jukebox with RFID cards. I want to mention a few of these that have inspired me.

I also want to link to two proprietary and commercial projects, because they were an inspiration in the early days of the Phoniebox. Since the first release, the Phoniebox code has shown the power of open source development. Today, Phoniebox might be the most versatile project of its kind.


If you like your Phoniebox, consider to buy me a coffee


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

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. Important notice: the hardware of the reader that I had linked here for a long times seems to have changed and suddenly created problems with the Phoniebox installation. The reader listed now has worked and was recommended by two Phoniebox makers (2018 Oct 4). I can not guarantee that this will not change and invite you to give RFID Reader feedback in this thread.

  • RFID Kit RC522: [RC522 Reader, Chip, Card for Raspberry Pi 13.56MHz] (https://amzn.to/2C7YZCZ)

    • 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

Arcade Buttons

Special hardware

These are links to additional items, which will add an individual flavour to your Phoniebox setup. Consult the issue threads to see if your idea has been realised already.

About

A Raspberry Pi jukebox, playing local music, podcasts and web radio, streams and spotify triggered by RFID cards and/or web app. All plug and play via USB. GPIO scripts available.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 30.7%
  • CSS 27.5%
  • Shell 26.8%
  • Python 13.5%
  • JavaScript 1.0%
  • C++ 0.4%
  • Hack 0.1%