# Octave

Octave is a containerised tool that syncs your Spotify playlists into a Jellyfin library, requests missing albums in Lidarr, and enriches album matching with ListenBrainz and Last.fm metadata. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3141/octave

## Description

Octave is a containerised tool that syncs your Spotify playlists into a Jellyfin library, requests missing albums in Lidarr, and enriches album matching with ListenBrainz and Last.fm metadata. Browser-based setup means no config-file editing is needed. Aimed at homelab media stacks already running Jellyfin and optionally Lidarr.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

51/100 (Fair), based on 4 of 4 factors.
- Maintained: 77 (last commit 73 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/octave-1m1vawj1y8tzlj?q=Octave

## Common questions

### Do I need to edit a config file to set up Octave?

No, you configure it in the web UI Settings after starting the container. You enter the Spotify Client ID and connect, then enter Jellyfin details and optional Lidarr details.

### Does Octave require a Spotify client secret?

No, normal setup uses PKCE Spotify OAuth and only needs the Spotify Client ID. Octave still accepts a Client Secret for legacy setups.

### Can Octave be protected if exposed to a browser?

Yes, it has optional HTTP Basic Auth for exposed deployments.

### Can Octave request missing albums in Lidarr?

Yes, it can request missing albums in Lidarr and track those queued albums across runs. It performs up to four concurrent album lookups.

### How do I schedule Octave syncs?

Scheduled syncs use the SYNC_SCHEDULE cron value, with the default at 2 AM UTC. You can also manually trigger a sync from the dashboard.

### Does Octave remember matches and run history between restarts?

It keeps a persistent track cache and library index, and stores every run in SQLite history. That history survives restarts cleanly.

---
Source: Our Local Host (https://ourlocalhost.com/app/3141/octave), the self-hosted and open-source app directory.
