[!IMPORTANT]
v5.3.0: Cross-Platform Release
QBZ-Downloader now ships official builds for Windows, macOS (Apple Silicon), and Linux. FFmpeg and fpcalc are bundled so audio conversion and AcoustID fingerprinting work out of the box. See 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/macOS/Linux 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.
Dive into detailed artist biographies and album credits.
📥 Download Management
Track your downloads with precision and history.
Keep your collection pristine.
📥 Installation
Desktop App (Windows, macOS, Linux)
QBZ-Downloader is built as a native desktop application. Install the ready-to-use build directly from GitHub Releases:
- Download the installer for your platform from Releases
- Windows:
.exe installer or portable .exe
- macOS:
.dmg disk image (Apple Silicon / arm64 only — Intel Macs not yet supported)
- Linux:
.AppImage (portable), .deb (Debian/Ubuntu), or .tar.gz
- Run the installer or the portable version.
- 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 (varies by platform):
- Windows:
release/QBZ-Downloader-Setup-<version>.exe / -Portable-<version>.exe
- macOS:
release/QBZ-Downloader-<version>-arm64.dmg
- Linux:
release/QBZ-Downloader-<version>-x86_64.AppImage / .deb / .tar.gz
⚙️ 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_IDQOBUZ_APP_SECRETQOBUZ_USER_AUTH_TOKENQOBUZ_USER_ID
Notes:
- No
.env file or manual configuration is required.
- App data is stored in your platform’s app data directory (e.g.
%APPDATA%/QBZ Downloader on Windows, ~/Library/Application Support/QBZ Downloader on macOS).
🏗️ System Architecture
graph TD
User[User] -->|Desktop App| 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
⚖️ Legal Disclaimer
Educational Use Only
This software is provided specifically for educational and personal archival purposes.
- No Bypass: This tool does not bypass DRM or region restrictions. It interacts with the API using your own valid credentials.
- Trademarks: “Qobuz” is a registered trademark of Xandrie SA. This project is not affiliated with Xandrie SA.
- Responsibility: Users are solely responsible for their actions and must comply with Qobuz’s Terms of Service.
Made with ❤️ by Muhammad Ibnu Fauzi
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
评论