Stars: 1158
Forks: 372
Pull Requests: 832
Issues: 971
Watchers: 64
Last Updated: 2023-09-10 21:03:40
A Raspberry Pi jukebox, playing local music, podcasts, web radio and streams triggered by RFID cards, web app or home automation. All plug and play via USB. GPIO scripts available.
License: MIT License
Languages: Python, Shell, PHP, CSS, Hack, C++, JavaScript
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.
Spotify has disabled access to libspotify on May 16, 2022.
This means Spotify in Phoniebox doesn't work at the moment, as Phoniebox can not communicate with Spotify via libspotify (and mopidy-spotify) anymore.
The problem is not our code but the cut off by Spotify. We want Phoniebox users to be able to connect their box to their Spotify accounts and play their content. The possibilities Spotify offers are -- at first glance -- not supporting an integration with Phoniebox.
Third party projects like librespot-java enter a grey zone regarding violation of Spotify's Terms of Services (ToS). For a potential Spotify re-integration, we are committed to a Spotify ToS compliant way of doing so (both in Version 2 and Version 3). This means looking into the (relatively new) Spotify Playback API, which is going to take an unknown amount of time.
This leaves us in a pickle and we are happy to hear from developer talent in the Phoniebox community on how to move forward regarding Spotify integration.
We are also curious to learn about alternative services we can connect with and which you would like to see supported -- or have developed support for already: #1835
Another bunch of wonderful designs! 2023 is the fifth Phoniebox calendar. If you are interested, you can see the 2019, 2020, 2021 and 2022 calendars in the docs folder. Download the printable PDF of 2023 here.
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.
If you are looking for the latest stable version 2.x, use the install script for Raspberry Pi.
Just as the year ends, we have put together a small update for Version 3 with bug fixes and documentation fixes.
And, of course you still have all the goodies that were introduced in Version 3.2.0:
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.
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.
Phoniebox 2.4.0 released (2022-12-18).
evdev
bug (fixes e.g. #1721, #1653, #1618, #1501 etc.)index-lcd.php
in web app)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.
In the Manual you will learn:
There is a growing section of troubleshooting including:
daemon_rfid_reader.py
only works via SSH not by RFID cards.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.
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.
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.
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.
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.
If you like your Phoniebox, consider to buy me a coffee or donate via PayPal to [email protected] using the friends option.
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:
The web app runs on any device and is mobile optimised. It provides:
cover.jpg
).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.
You might be surprised how easy and affordable you can get a RaspberryPi or an "appropriate" housing for your Phoniebox second hand. Think about the planet before you buy a new one. Creating a Phoniebox may be sustainable for the following reasons:
Read the CONTRIBUTING.md file for more infos on how to contribute code.
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.