🎵 QBZ-Downloader

The Ultimate High-Resolution Audio Downloader & Library Manager

Unlock the full potential of your music library.

A comprehensive desktop-first music downloading and library management application for Windows. Experience studio-quality audio up to 24-bit/192kHz with complete metadata, synchronized lyrics, intelligent queue management, and a polished EXE workflow.

✨ Features • 📥 Installation • ⚙️ Configuration • 🖥️ Desktop Mode • 📸 Screenshots

Important

v5.2.1: Stability Patch This update fixes batch staging cleanup, improves library metadata issue reporting, and hardens metadata auto-fix error handling. Check the Changelog for full details.

---

✨ Key Features

Everything you need to build the perfect local music library.

Feature	Description
🎵 Studio Quality	Download in Hi-Res FLAC (up to 24-bit/192kHz). Bit-perfect replicas of the source.
🖥️ Modern Desktop UI	Beautiful React & Vite interface with Light/Dark Mode, real-time updates, and smooth animations.
🎤 Live Lyrics	Experience synchronized lyrics with 60fps smooth scrolling. Includes a built-in Lyrics Editor.
🏷️ Smart Tagging	Automatic tagging with High-Res Cover Art, Artist, Album, Year, Genre, ISRC, and more.
📦 Batch Power	Download Full Albums, Artist Discographies, or Playlists with a single click.
📚 Library Manager	Scans your library to detect duplicates, identify missing metadata, and suggest upgrades.
🎼 Visualizer	Built-in real-time audio visualization for an immersive listening experience.
📊 Analytics	Visualize your collection with charts: quality distribution, top artists, and storage mastery.
🔄 Resumable	New! Support for HTTP Range to resume interrupted downloads seamlessly.
🔌 Bandwidth Ctrl	New! Limit download speed to save bandwidth for other activities.
🔐 Encrypted Auth	Sensitive Qobuz credentials are now encrypted in the local database.
🌍 Spotify Migration	Import your playlists from Spotify directly into Qobuz for high-res downloading.
🔍 Quality Scan	New! Automated spectral analysis to detect upsampled/fake lossless files.
📡 Media Sync	New! Auto-notify Plex or Jellyfin to rescan library after download.
📤 Auto Export	New! Automatically convert FLAC to MP3/AAC/Opus for mobile devices.
👀 Playlist Watcher	New! Automatically monitor and sync new tracks from your favorite playlists.
🧩 Desktop Runtime	Optimized for Windows EXE delivery with local-first configuration and storage.

---

📸 Interface Showcase

Explore the beautiful, functional interface of QBZ-Downloader.

🔍 Discovery & Search

Quickly find your music with our optimized search engine.

👤 Deep Metadata Exploration

Dive into detailed artist biographies and album credits.

📥 Download Management

Track your downloads with precision and history.

📚 Library Tools

Keep your collection pristine.

---

📥 Installation

Desktop EXE (Windows)

QBZ-Downloader is built as a native Windows application. Install the ready-to-use EXE directly from GitHub Releases:

1. Download the latest .exe from Releases.
2. Run the installer or the portable version.
3. Complete the onboarding process and enter your Qobuz credentials in Settings.

Development Build

If you wish to build the EXE from source:

# 1. Install dependencies
npm install

# 2. Build both client and server
npm run build:full

# 3. Create installer
npm run desktop:dist

Output paths:

• Installer: release/QBZ-Downloader-Setup-<version>.exe
• Portable: release/QBZ-Downloader-Portable-<version>.exe

---

⚙️ Configuration

All settings are managed directly within the app's Settings UI and stored in a local SQLite database.

🔑 Authentication

Configure these in the app:

• QOBUZ_APP_ID
• QOBUZ_APP_SECRET
• QOBUZ_USER_AUTH_TOKEN
• QOBUZ_USER_ID

Notes:

• No .env file or manual configuration is required.
• App data is stored in %APPDATA%/QBZ Downloader (Installer) or QBZ-Data/ (Portable).

---

🏗️ System Architecture

graph TD
    User[User] -->|Windows EXE| Desktop[Electron Desktop App]
    Desktop -->|Local WebSocket/REST| Server[Node.js Local Service]
    
    subgraph Backend Services
        Server --> API[Qobuz API Client]
        Server --> Queue[Queue Manager]
        Server --> DB[(SQLite Database)]
        Queue --> Downloader[Download Engine]
        Downloader --> FS[File System]
    end

Loading

---

⚖️ Legal Disclaimer

Educational Use Only This software is provided specifically for educational and personal archival purposes.

1. No Bypass: This tool does not bypass DRM or region restrictions. It interacts with the API using your own valid credentials.
2. Trademarks: "Qobuz" is a registered trademark of Xandrie SA. This project is not affiliated with Xandrie SA.
3. Responsibility: Users are solely responsible for their actions and must comply with Qobuz's Terms of Service.

---

Made with ❤️ by Muhammad Ibnu Fauzi