Upgrade

Upgrade your Phoniebox to a newer version

Version: 19 Jan 2020 (the date is important, because I am not sure how ofter this file will be updated compared to the code base)

The latest code base requires the Pi OS buster.

Upgrade if you run on buster

The best way to upgrade would be running the one-line-install script.

If you run the script on top of an existing installation, the installer will detect the existing installation and ask you what to do (use audio files, use RFID configs, etc.). See below for details.

Upgrade if you run on stretch

If you plan to upgrade...

1. Make a backup first. Ideally, backup the entire folder
   • `home/pi/RPi-Jukebox-RFID
2. Then install a fresh buster system on a SD-Card
3. Copy your backup to the new SD-Card, so that you have the same location as before:
   • `home/pi/RPi-Jukebox-RFID
4. Run the one-line-install script
   • The script will detect your Phoniebox folder (which is why it is important that it's in the same location!)

How the install script reacts with an existing installation

When you start the installer, early on, after the WiFi settings, this will come up:

#####################################################
#
# . . . * alert * alert * alert * alert * . . .
# 
# WARNING: an existing Phoniebox installation was found.
# 
IMPORTANT: you can use the existing content and configuration files 
for your new install.
Whatever you chose to keep will be moved to the new install.
Everything else will remain in a folder called 'BACKUP'.

Re-use config, audio and RFID codes for the new install? [Y/n]

If you type Y you will get the following options:

Ok. You want to use stuff from the existing installation."
What would you want to keep? Answer now."

RFID config for system control (e.g. 'volume up' etc.)? [Y/n]
RFID shortcuts to play audio folders? [Y/n]
Audio folders: use existing? [Y/n
GPIO: use existing file? [Y/n]
Sound effects: use existing startup / shutdown sounds? [Y/n]