INSTALL

Installing Phoniebox

Warning

The Phoniebox software V2.x currently does not support Raspberry Pi OS Bookworm!

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.

• One line install command
• Install Raspberry Pi OS (previously Raspbian) on your RPi

This project has been tested on Raspberry Pi model 1, 2, 3, 4, and Zero.

One line install command

There is a one line script. 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.

A. Default install script (recommended)

Uses the latest release from the master branch.

⚠️ Spotify has disabled access to libspotify on May 16, 2022. This means currently Phoniebox and many other services can not communicate with Spotify via libspotify (and mopidy-spotify) anymore. The problem is not our code but the cut off by Spotify. For more information, read the Spotify-FAQ.

cd; rm buster-install-*; wget https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/master/scripts/installscripts/buster-install-default.sh; chmod +x buster-install-default.sh; ./buster-install-default.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 buster-install-* - remove previously downloaded versions of the install script
• wget https://raw.githubusercont... - download the actual install script from github
• chmod +x buster-install-default.sh - make the script executable
• ./buster-install-default.sh - run the script

B. Developer install 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 buster-install-*; wget https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/develop/scripts/installscripts/buster-install-default.sh; chmod +x buster-install-default.sh; GIT_BRANCH=develop bash ./buster-install-default.sh

Install Raspberry Pi OS (previously Raspbian) on your RPi

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.

• The 32-bit Version is essential. 64-bit is not supported.
• Use the 'lite'-Version if you want to have a headless installation and configuration via ssh.

Installation steps:

1. Connect your Micro SD card (through a card reader) to your computer
2. Download the Raspberry Pi Imager and open it
3. Select Raspberry Pi OS to use the latest release in the desktop version
   • if you want to use another release or version, choose Raspberry Pi OS (other)
   • if you want to use a preloaded image, choose Use Custom
4. Select your Micro SD card (your card will be formatted)
5. Open Settings and ...
   • make sure to use the username 'pi' (other usernames are currently not supported)
   • enable and configure Wifi
   • enable and configure SSH access
   • configure locale settings
6. Click Write
7. 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.

Autologin after boot

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.