QBZ is a free and open source (FOSS) Qobuz client for Linux with native, high-fidelity playback. It is a real desktop application, not a web wrapper, so it can use DAC passthrough, switch sample rates per track, and deliver bit-perfect audio.
Browsers cap audio output around 48 kHz, while Qobuz streams up to 192 kHz. QBZ uses a native playback pipeline with direct device control, exclusive mode, and no forced resampling so your system and DAC receive the original resolution, with caching and system integrations that wrappers cannot provide.
# Using yay
yay -S qbz-bin
# Using paru
paru -S qbz-bin# Download from releases
flatpak install ./QBZ.flatpakDownload the latest release from the Releases page.
chmod +x QBZ.AppImage
./QBZ.AppImageDownload the .deb from Releases.
sudo apt install ./qbz_*.debDownload the .rpm from Releases.
sudo dnf install ./qbz-*.rpmNote: Pre-built binaries include all API integrations (Last.fm, Discogs, Spotify, Apple Music, Tidal, Deezer) ready to use. If you build from source, you'll need to provide your own API keys.
Coming soon.
- Qobuz authentication and full catalog search (albums, tracks, artists, playlists).
- Native decoding for FLAC, MP3, AAC, and ALAC with real-time playback state updates.
- Quality selection with automatic fallback across Qobuz tiers.
- Audio device enumeration and per-device output selection.
- Exclusive mode and DAC passthrough for bit-perfect playback.
- Preserve original sample rates end-to-end where supported.
- Gapless-ready playback pipeline with precise position tracking.
- Queue management with shuffle, repeat, and history navigation.
- In-memory audio cache with LRU eviction and next-track prefetching.
- Favorites and playlists from your Qobuz account.
- Local library backend: directory scanning, metadata extraction, CUE sheet parsing, and SQLite indexing.
- Grid and list views with search, A-Z index, and grouping by artist or album.
- Multi-disc album grouping with disc headers in album views.
- Local artwork detection (folder and embedded) with Discogs fallback.
- Import public playlists from Spotify, Apple Music, Tidal, and Deezer into your Qobuz library.
- Automatic track matching with fuzzy search.
- Batch import with progress tracking.
- Chromecast device discovery and streaming.
- DLNA/UPnP device discovery and streaming (AVTransport SOAP).
- Unified cast picker with protocol selection.
- Seamless playback handoff to network devices.
- MPRIS media controls and media key support on Linux.
- Desktop notifications for track changes.
- Last.fm scrobbling and now-playing updates.
- Discogs artwork fetching for local library.
- Shareable Qobuz URLs and universal SongLink links (Odesli).
- Now playing, queue panel, and full-screen playback views.
- Focus mode for distraction-free listening.
- Mini player mode.
- Keyboard shortcuts for common actions.
- English and Spanish localization.
- Audio device selection and quality preferences.
- API keys configuration for self-hosted builds.
- Theme and appearance options.
- Low CPU usage in idle and playback with adaptive audio thread scheduling.
QBZ is MIT-licensed and fully open source. No telemetry, no lock-in, and no hidden services. Just a clean, transparent player built for Linux audio fans.
QBZ draws inspiration from projects like qobuz-dl, and from the broader Linux audio community that values open tools and high-fidelity playback.
- Desktop: Rust + Tauri 2
- Frontend: SvelteKit 5 + TypeScript + Vite
- Audio: rodio + symphonia
- Networking: reqwest
- Local library: walkdir + lofty + rusqlite
- Integrations: souvlaki (MPRIS), notify-rust, SongLink (Odesli)
- UX: svelte-i18n, lucide-svelte
- Rust (latest stable)
- Node.js 20+
- Linux with audio support (PipeWire, ALSA, or PulseAudio)
- System dependencies:
webkit2gtk-4.1,gtk3,alsa-lib
# Clone the repository
git clone https://github.com/vicrodh/qbz.git
cd qbz
# Install dependencies
npm install
# Run in development mode
npm run tauri dev
# Build for production
npm run tauri buildAPI keys are only required when you build QBZ yourself. The app runs without them, but the corresponding features will be disabled.
API keys and integrations (optional)
When building from source, you need to provide your own API keys. Copy the example environment file:
cp .env.example .env- Go to Last.fm API Account
- Create a new application
- Add to
.env:
LAST_FM_API_KEY=your_api_key
LAST_FM_API_SHARED_SECRET=your_shared_secret- Go to Discogs Developer Settings
- Create a new application
- Add to
.env:
DISCOGS_API_CLIENT_KEY=your_consumer_key
DISCOGS_API_CLIENT_SECRET=your_consumer_secret- Go to Spotify Developer Dashboard
- Create a new application
- Add to
.env:
SPOTIFY_API_CLIENT_ID=your_client_id
SPOTIFY_API_CLIENT_SECRET=your_client_secret- Go to Tidal Developer Portal
- Create a new application
- Add to
.env:
TIDAL_API_CLIENT_ID=your_client_id
TIDAL_API_CLIENT_SECRET=your_client_secretNote: All integrations are optional. The application will work without them, but the corresponding features will be disabled.
qbz/
├── src/ # Frontend (SvelteKit)
├── src-tauri/
│ └── src/
│ ├── api/ # Qobuz API client
│ ├── player/ # Audio playback engine
│ ├── queue/ # Queue management
│ ├── cache/ # Audio cache and prefetch
│ ├── cast/ # Chromecast & DLNA casting
│ ├── library/ # Local library backend
│ ├── lastfm/ # Last.fm integration
│ ├── discogs/ # Discogs integration
│ ├── playlist_import/ # Spotify/Tidal import
│ ├── share/ # SongLink / share utilities
│ ├── media_controls/ # MPRIS integration
│ └── commands/ # Tauri IPC commands
├── packaging/
│ ├── aur/ # Arch Linux PKGBUILD
│ └── flatpak/ # Flatpak manifest
└── static/ # Static assets and logo
Contributions are welcome! Please feel free to submit issues and pull requests.
QBZ is built for Linux first, but the codebase can compile on macOS in many cases. Expect missing integrations and bugs, especially around audio devices, exclusive mode, MPRIS, and platform-specific packaging.
If you want to try it:
npm install
npm run tauri devPlease treat macOS support as best-effort and report issues with clear logs.
MIT