Settings — Qobuz Librarian

Qobuz Authentication

Your credentials are stored in the container's config volume and never leave your server. To find your auth token: open the Qobuz desktop app → Help → Debug → copy user_auth_token, or run rip config open and look for password_or_token under [qobuz].

Behaviour

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

Prefer hi-res master

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. Most people leave this off.

Fetch lyrics

Look up synced/plain lyrics on import.

Details

Download quality 1 = 320 kbps · 2 = CD/16-bit lossless · 3 = 24-bit ≤96 kHz · 4 = 24-bit ≤192 kHz (best master Qobuz serves). 2 if you want smaller files.

Lyrics format How lyrics are written when fetched.

Lyrics providers Comma-separated list of providers to try in order (e.g. Lrclib,NetEase). Empty = built-in default.

beets path: default Folder/file naming for normal albums (beets path syntax). Empty = use whatever is in beets/config.yaml.

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

These are set via environment variables in compose.yaml. Restart the container after changing them.

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 — 0 entries
✓	Staging (STAGING_DIR)	/staging — 0 entries
!	Beets DB (BEETS_DB_PATH)	/config/beets/musiclibrary.db not created yet (will be created on first import)
✓	`rip` binary	/opt/venv/bin/rip
✓	`beet` binary	/opt/venv/bin/beet
✓	`ffprobe` binary	/usr/bin/ffprobe