Quadify Setup Guide

Quadify hardware front panel with buttons and rotary control

This guide walks you through installing, wiring, and configuring Quadify on a Raspberry Pi running Volumio. Follow the steps in order — each one builds on the previous.

Recommended setup order

  1. Install Volumio
    Prepare the SD card and flash Volumio.
  2. Connect Volumio to Wi-Fi
    First boot, network setup, and DAC configuration.
  3. Headless Setup & Terminal Access
    Enable SSH and connect to the Pi remotely.
  4. Install Quadify (Plugin)
    Follow the official GitHub instructions.
  5. Wiring the Modules
    Power, screen, rotary encoder, and terminal HAT.
  6. OLED Screen Setup
    Check and wire the SSD1322 display correctly.
  7. MCP23017 Board Install
    Expand GPIO for buttons and LEDs.
  8. Buttons & LEDs
    Wire the button matrix and LED outputs.

A few notes before you start

Quadify is designed to be simple, robust, and serviceable.

Need help or want to share your build?

If you get stuck, have a question, or just want to show off your Quadify build, the Discord server is the best place to do it.

Join the Quadify Discord

This is the fastest way to get support and see how others are building their systems.