Local Library

Local Library

QBZ can scan and play your local music files alongside Qobuz streaming content, all from the same interface.

Adding Music Folders

1. Go to Settings > Local Library
2. Click Add Folder
3. Select the directory containing your music files
4. QBZ will scan and index the folder

You can add multiple folders. QBZ watches for changes and re-scans automatically.

Supported Formats

QBZ uses the Symphonia decoder, which supports:

Format	Extensions	Notes
FLAC	.flac	Lossless, up to 192 kHz / 24-bit
WAV	.wav	Uncompressed PCM
AIFF	.aiff, .aif	Apple lossless format
MP3	.mp3	MPEG Layer 3
AAC	.m4a, .aac	Advanced Audio Coding
OGG Vorbis	.ogg	Open lossy format

Metadata and Tags

QBZ reads metadata using the lofty library:

• ID3v2 (MP3)
• Vorbis Comments (FLAC, OGG)
• RIFF INFO (WAV)
• MP4/M4A atoms (AAC)

Metadata fields read:

• Title, artist, album, album artist
• Track number, disc number
• Genre, year
• Album artwork (embedded)
• Duration, sample rate, bit depth

CUE Sheets

QBZ supports CUE sheet parsing for albums stored as a single audio file with a .cue file describing the track layout.

• Place the .cue file alongside the audio file
• QBZ will split it into individual tracks automatically
• Each track appears separately in your library

Tag Editor

QBZ includes a built-in tag editor for local files:

1. Right-click a local track and select Edit Tags
2. Modify the metadata fields
3. Save your changes

Sidecar storage: Tag edits are stored in a sidecar database rather than modifying your original files. Your source files are never touched.

Multi-Disc Albums

QBZ automatically groups multi-disc albums based on disc number metadata. Albums with multiple discs display disc separators in the track listing.

Browsing Your Library

From the Local Library section in the sidebar, you can browse by:

• Albums — grid or list view
• Artists — alphabetical with album counts
• Tracks — full track listing with search and filters
• Genre — filter by genre tags

Search and Filters

Use the search bar in the Local Library view to filter by:

• Track title
• Artist name
• Album name

Genre filters are available as quick-access buttons.

Playback

Local files play through the same audio pipeline as Qobuz streams:

• Same audio backend (PipeWire, ALSA, ALSA Direct, PulseAudio)
• Same bit-perfect capabilities
• Same sample rate switching
• Same gapless playback
• Same queue, shuffle, and repeat controls

You can mix local files and Qobuz streams in the same queue.