Updating Quadify
ms

matt shepherd

Created Oct 23, 2024

Updating Quadify

We’re about to update the Quadify system by pulling the latest code from GitHub. This will ensure that you’re working with the most recent improvements, bug fixes, and features. The process involves synchronising your current setup with the latest changes in the repository, ensuring everything is up to date for optimal performance. This update won't overwrite your personal configurations but will integrate the new codebase enhancements smoothly into your existing setup.

76
1

Step #1

To refresh how to SSH into your Volumio setup, follow these basic steps:

  1. Open a terminal (Terminus or Putty) on your computer.

  2. Use the SSH command to connect to your Volumio device.

  3. Enter the password when prompted. The default password is volumio unless you've changed it.

Once connected, you're ready to proceed with updating the Quadify code.

2

Step #2

The next step is to stop the oled.service and remove the old Quadify folder:

1. Stop the OLED service by running:

sudo systemctl stop oled.service

2. List the contents of your home folder to find the old Quadify directory:

ls

3. Remove the old Quadify folder (likely named quadify-volumio or similar) by typing:

sudo rm -R <folder-name>

Replace <folder-name> with the actual folder name listed from the ls command.

3

Step #3

The next step is to download the new Quadify repository from GitHub:

1. Navigate to your home directory if you're not already there:

cd

2. Clone the new repository by running the following command:

git clone https://github.com/theshepherdmatt/Quadify.git

This will download the latest Quadify code into a new folder called Quadify. You’re now ready to proceed with setting it up.

4

Step #4

For the next step:

1. Change directory into the Quadify/oled folder:

cd Quadify/oled

2. Run the new install script:

sudo bash install.sh

Running this script might not always be necessary, but it ensures all dependencies and configurations are properly set up for the new version of Quadify. You can choose to skip this if you are confident that everything is already installed correctly.

5

Step #5

Finally, the last step is to reboot your Volumio system to apply all the changes:

sudo reboot

This will restart the system, and when it comes back online, your updated Quadify setup should be fully functional. After the reboot, everything should be ready, and the new OLED service will start automatically.

6

Also.....

Additionally, for the new code to work properly, you need to set up your playlists in Volumio beforehand. The code relies on having playlists configured to function as intended. If you're encountering any issues with this step, feel free to reach out on Discord, and I can assist you in getting everything sorted out.

7

Debugging

One common issue could be that the buttons and LEDs aren't working. This might be due to differences in wiring between the old and new MCP23017 boards. In particular, the new code uses address 0x20 for the MCP23017, while older versions used address 0x27. This is easy to fix in the code, so if you're encountering this, just drop me a message on Discord, and I can guide you through making the necessary adjustments.

https://discord.gg/V7c6Abnh9K

Well done!
Create how-to guides like this in a snap. Get Tango now.