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.

Important

At least the PhonieBox v2.x is relying that your username is set to the standard (pi). It is recommended to stick to that. Otherwise the installation of the PhonieBox software or some modules will fail.

• 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 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.

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 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

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.

• Use the 'lite'-Version if you don't need a Desktop UI and want to make configuration via ssh.

Installation steps:

1. Connect a Micro SD card to your computer (preferable an SD card with high read throughput)
2. Download the Raspberry Pi Imager and run it
3. Click on "Choose Device" and select "No filtering"
4. 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
5. Select your Micro SD card (your card will be formatted)
6. 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 currently MUST be pi. Other usernames are currently 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
   • Click Yes to use Settings
7. Click Write
8. Confirm the next warning about erasing the SD card with Yes
9. 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.