-
Notifications
You must be signed in to change notification settings - Fork 401
INSTALL
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.
This project has been tested on Raspberry Pi model 1, 2, 3, 4, and Zero.
There are a number of operating systems to chose from on the official RPi download page.
Currently we recommend to use the latest legacy release image.
- Use the 'lite'-Version if you don't need a Desktop UI and want to make configuration via ssh.
Installation steps:
- Connect a Micro SD card to your computer (preferable an SD card with high read throughput)
- Download the Raspberry Pi Imager and run it
- Click on "Choose Device" and select "No filtering"
- Click on "Choose OS" and select "Raspberry Pi OS (other)"
- Select Raspberry Pi OS (Legacy) Lite (prefered for Phoniebox)
- if you need a desktop environment, select the non lite version
- if you want to use a preloaded image, go back and choose Use Custom
- Select Raspberry Pi OS (Legacy) Lite (prefered for Phoniebox)
- Select your Micro SD card (your card will be formatted)
- After you click
Next
, a prompt will ask you if you like to customize the OS settings- Click
Edit Settings
and configure- At the
General
tab- Provide a hostname.
β οΈ Username MUST bepi
. Other usernames are not supported.- User Password
- Wifi
- locale settings
- At the
Services
tab.- Enable SSH with "Use password authentication"
- At the
Options
tab.- Disable "Telemetrie" if you like
- Click
Save
- At the
- Click
Yes
to use Settings
- Click
- Click
Write
- Confirm the next warning about erasing the SD card with
Yes
- Wait for the imaging process to be finished (it'll take a few minutes)
Plug the SD into your Pi and optionally connect keyboard, monitor and mouse. And fire it up.
See the official RPi guide for further information.
When you start the Phoniebox, it needs to fire up without stalling at the login screen. This can also be configured using the RPi config tool.
Open a terminal to star the RPi configuration tool.
$ sudo raspi-config
Select Boot options
and then Desktop / CLI
. The option you want to pick is Console Autologin - Text console, automatically logged in as 'pi' user
.
There is a one line script for Raspberry Pi OS. Copy and paste it into your Pi terminal - if you have your
- Raspberry Pi OS up and running and
- are connected to the Internet
This script gets your Phoniebox up and running and automatically configures all necessary parts. Once you finished the installation, read the manual to add audio files and RFID cards.
Uses the latest release from the master
branch.
cd; rm install-jukebox.sh; wget https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/master/scripts/installscripts/install-jukebox.sh; chmod +x install-jukebox.sh; ./install-jukebox.sh
Having said this, you might learn a bit more about your Raspberry Pi to walk through the installation process step by step, like this:
The one line install command contains five separate commands linked up by replacing the end of line with ;
. The commands do the following:
-
cd
- move to the home directory -
rm install-jukebox.sh
- remove previously downloaded versions of the install script -
wget https://raw.githubusercont...
- download the actual install script from github -
chmod +x install-jukebox.sh
- make the script executable -
./install-jukebox.sh
- run the script
For latest updates, try the version in the develop
branch. Attention: itβs likely that things on develop are broken or have to be changed by yourself.
cd; rm install-jukebox.sh; wget https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/develop/scripts/installscripts/install-jukebox.sh; chmod +x install-jukebox.sh; GIT_BRANCH=develop bash ./install-jukebox.sh
If you like Phoniebox, consider: buy me a coffee or PayPal
- Code: https://github.com/MiczFlor/RPi-Jukebox-RFID
- Phoniebox home page: English | Deutsch
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.
Visit Phoniebox.de
π₯ Version 3
- β Releases
- π΅ Install Jukebox Version 3
- π Report a bug
- π Propose a feature
- βοΈ Feature Status
- π Documentation
- π©βπ» Development
- βοΈ Contributing
- π¦ Code
πΆ Version 2
- β Releases
- π΅ Install Jukebox Version 2
- π Report a bug
- βοΈ Features
- π Documentation
- βοΈ Contributing
- π¦ Code
Version 2 Pages
-
Setup / Upgrades
- Synchronising Phonieboxes in a local network
- Smart Home remote control with MQTT
- Hardware Pinout Overview
- Systemwide Equalizer
- Phoniebox with read-only Filesystem
- HiFiBerry Soundcard Details
- WM8960 Hi-Fi HAT
- PAM8403 Amplifier Power Off
- TPA3118 Amplifier Power Off and EMI improvement
- External Non USB Audio DAC ES9023, PCM5102, etc.
- On-board LEDs with fibre optics
- Setting GPIOs at boot time
- Stop on removal with USB RFID Reader
- Firmware update improves audio out
- Architecture