Settings — Qobuz Librarian

Qobuz authentication

Qobuz has no public login, so the app reuses the token your own browser already holds — you copy it once, and it's stored only on your server, never sent anywhere but Qobuz. To find it (about 30 seconds): sign in at play.qobuz.com, open dev tools (F12) → Application → Local Storage → play.qobuz.com, and copy the localuser entry's token — the id next to it is your user ID.

Mode

The web app and the command-line tool can't run at the same time — they share one download lock. Hand control to the terminal here, run your CLI commands (docker exec -it qobuz-librarian qobuz-librarian), then resume. Downloads in the web UI are paused while the terminal has control.

Web app active The CLI is locked out.

Behaviour

These take effect on the next job — no restart needed. They override the defaults from compose.yaml.

Prefer Hi-Res

When an album has several versions, pick the highest-quality one. Off picks the earliest release instead.

Consolidate duplicate folders (CLI only)

After import, merge sibling/duplicate album folders into one. Consolidation needs interactive per-folder confirmation and only runs from the CLI; this toggle has no effect on web downloads.

Migrate multi-artist folders

Move 'Primary, Other/<album>' into 'Primary/<album>' after import.

Offer upgrades during walks

Let ordinary gap-fill walks also surface quality upgrades. The explicit Upgrade scan always works regardless of this.

Downsample hi-res before import

Resample 88.2/96 kHz+ FLACs to 44.1/48 kHz to save space.

Fetch lyrics

Look up synced/plain lyrics on import.

Details

Download quality A ceiling, not a guarantee: Qobuz delivers the highest quality it has for each release, up to this. Hi-res isn't available for every album.

Lyrics format How lyrics are written when fetched.

Album art Where cover art goes: a file in the album folder (sidecar), embedded in the track tags with no leftover file (embed), or both.

Lyrics providers Comma-separated list of providers to try in order. Available: Lrclib, NetEase, Megalobiz, Musixmatch, Genius, Deezer, TextyL. Unknown names are ignored. Empty = default (Lrclib, NetEase, Musixmatch).

beets path: default Folder/file naming for normal albums (beets path syntax). Empty = use whatever is in beets/config.yaml (check /config/beets/config.yaml to see the current value).

beets path: singleton Naming for singleton tracks. Empty = beets default.

beets path: compilation Naming for compilations / Various Artists. Empty = beets default.

beets plugins Comma-separated list of beets plugins to enable. Replaces the list in /config/beets/config.yaml entirely. Empty = honour that file (seeded with fetchart only). Examples: lastgenre, replaygain, scrub, edit.

Container paths

Where the container reads and writes inside its own filesystem. The defaults work for a normal Docker install — only worth touching if you've changed the bind mounts in compose.yaml. A restart is required after editing.

MUSIC_ROOT: /music
STAGING_DIR: /staging
BEETS_DB_PATH: /config/beets/musiclibrary.db
STREAMRIP_CONFIG: /config/streamrip/config.toml

Diagnostics

Read-only checks from the container's point of view. Run these before your first scan to catch an unmounted or unwritable volume.

✓ Music library (MUSIC_ROOT) /music — 1882 entries

✓ Staging (STAGING_DIR) /staging — 0 entries

✓ beets DB (BEETS_DB_PATH) /config/beets/musiclibrary.db (created on first import)

✓ `rip` binary /opt/venv/bin/rip

✓ `beet` binary /opt/venv/bin/beet

✓ `ffprobe` binary /usr/bin/ffprobe

✓ Stranded upgrade backups none