Skip to content

APT repository

apt.odio.love hosts the signed .deb packages for the odio stack, produced by the CI/CD pipeline on every component release. Configuring it on a Debian, Raspberry Pi OS, Ubuntu, or Armbian system gives you apt install access to every odio component.

The odios installer adds the repository automatically, so a fresh odio node doesn’t need any of this. The steps below are for adding the repo manually on an existing Debian-family system, typically to install a single component standalone (odio-api on a desktop, mpd-discplayer on an MPD-only host, etc.).

Terminal window
curl -fsSL https://apt.odio.love/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/odio.gpg
echo "deb [signed-by=/usr/share/keyrings/odio.gpg] https://apt.odio.love stable main" | sudo tee /etc/apt/sources.list.d/odio.list
sudo apt update

After this, every package below is one sudo apt install <name> away.

PackageSourceWhat it is
odio-apigo-odio-apiThe core REST API + embedded UI.
mpd-discplayergo-mpd-discplayerCD and USB auto-play daemon for MPD.
mpdris2mpDris2MPRIS bridge for MPD, with as_directory-aware cover-art lookup.
snapclientmprissnapclientmprisMPRIS bridge for the local Snapcast client.
mympdodio-mympdThe myMPD web UI, tracked daily against upstream.
spotifydspotifydSpotify Connect daemon.

All packages are built for amd64, arm64, armhf, and armv7hf; pure-Python packages (mpdris2, snapclientmpris) ship as arch:all and work on every architecture.

The default stable suite ships only tagged stable releases. To opt into pre-releases (-rc, -beta, -alpha), swap stable for testing in /etc/apt/sources.list.d/odio.list and sudo apt update. Both suites cover the same package set; testing simply tracks the latest pre-release version of each.

The same machine can switch back and forth, useful for trying a new release candidate without reinstalling.