Installing Phoniebox future3¶
Install Raspberry Pi OS Lite¶
Important
Currently, the installation does only work on Raspberry Pi’s with ARMv7 and ARMv8 architecture, so 2, 3 and 4! Pi 1 and Zero’s are currently unstable and will require a bit more work!
Before you can install the Phoniebox software, you need to prepare your Raspberry Pi.
Connect a Micro SD card to your computer (preferable an SD card with high read throughput)
Download the Raspberry Pi Imager and open it
Select Raspberry Pi OS Lite (32-bit) (without desktop environment) as the operating system (only the 32 bit version is supported) (you can use the settings menu of the Raspberry Pi Imager to configure SSH and WiFi in a more userfriendly way, or do it manually as described in the next step)
Select your Micro SD card (your card will be formatted)
Click Write
Wait for the imaging process to be finished (it’ll take a few minutes)
Pre-boot preparation¶
You will need a terminal, like PuTTY for Windows or the Terminal app for Mac to proceed with the next steps.
Open a terminal of your choice.
Insert your card again if it has been ejected automatically.
Navigate to your SD card e.g.,
cd /Volumes/boot
for Mac orD:
for Windows.Enable SSH by adding a simple file.
$ touch ssh
Set up your Wifi connection.
Mac
$ nano wpa_supplicant.conf
Windows
D:\> notepad wpa_supplicant.conf
Insert the following content, update your country, Wifi credentials and save the file.
country=DE ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 network={ ssid="network-name" psk="network-password" }
Eject your SD card and insert it into your Raspberry Pi.
Start your Raspberry Pi by attaching a power supply.
Login into your Raspberry Pi, username is
pi
and password israspberry
. Ifraspberrypi.local
does not work, find out your Raspberry Pi’s IP address from your router.
Install Phoniebox software¶
Run the following command in your SSH terminal and follow the instructions
cd; bash <(wget -qO- https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/future3/main/installation/install-jukebox.sh)
This will get the latest stable release from the branch future3/main. To install directly from a specific branch and/or a different repository specify the variables like this:
cd; GIT_USER='MiczFlor' GIT_BRANCH='future3/develop' bash <(wget -qO- https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/future3/develop/installation/install-jukebox.sh)
This will switch directly to the specified feature branch during installation.
Attention
For all branches except the current Release, you will need to build the Web App locally on the Pi. This is not part of the installation process due to memory limitation issues. See Steps to install.
If you suspect an error you can monitor the installation-process with
cd; tail -f INSTALL-<fullname>.log