Search, explore and download Lossless and Hi-Res music from Qobuz. This is a maintained fork of vitiko98/qobuz-dl, specifically optimized for my DJ workflow, but can work for other music collectors as well. Portable and easy to use.
(You can donate to vitiko98 the original author of qobuz-dl - I don't take any donations)
This version is tailored for building a performance-ready music library:
- GUI Mode (
gui): A graphical user interface for the application. - DJ Mode (
dj): A native top-level command for high-quality MP3s (320kbps), better metadata consistency, and embedded artwork. - Sanitization Mode (
sz): Keep your library tidy with automated sequential renumbering and playlist generation. - Top tracks Mode (
top): Download the top tracks of an artist. Don't miss greatest hits! - Smart Discography: Intelligently filters for the best versions of tracks, avoiding duplicates and prefering remasters.
- Modern Reliability: Fixed for Python 3.13, managed by uv, and built with automated CI/CD for all major platforms.
The most common command for building your library. It ensures maximum compatibility with Serato, Rekordbox, and Traktor.
qobuz-dj dj <url>This automatically enables:
- MP3 320kbps (For compatibility).
- Embedded Artwork (No loose
cover.jpgfiles). - Smart Filtering (Skips duplicates and promotional spam).
- Portable Folder Naming: Clean artist and album organization.
Already have a messy folder? Clean it up instantly:
qobuz-dj sz <path/to/folder>Matches your files to a strict NN - Artist - Title (Year) format and generates a companion .m3u playlist.
You'll need an active subscription to Qobuz
This project is optimized for uv.
- Run directly:
uv run qobuz-dj - Install as tool:
uv tool install .
No Python? No problem. Download the pre-compiled qobuz-dj executable from the Github Releases page, for:
- 🪟 Windows (
.exe) - 🐧 Linux
- 🍎 macOS
| Command | Mode | Description |
|---|---|---|
dj |
DJ Mode | Recommended. Shortcut for dl -D. Optimized for performance. |
dl |
Input Mode | Standard downloads with full control over quality and tags. |
sz |
Sanitize | Rename and renumber existing folders + create playlists. |
fun |
Interactive | Search and explore music directly in your terminal. |
lucky |
Lucky | Download the top results for any search query. |
Download a specific album in FLAC (Quality 6):
qobuz-dj dl <url> -q 6Download the Top 10 tracks of an artist, formatted specifically for your DJ software:
qobuz-dj dj -T 10 <artist_url>qobuz-dj lucky "daft punk homework" --type albumThis project uses poethepoet for automation.
uv run poe check: Code quality checks.uv run poe test: Run the test suite.uv run poe build: Compile your own standalone executable.
I will not be responsible for how you use qobuz-dj.
This tool DOES NOT include...
- Code to bypass Qobuz's region restrictions.
- Qobuz app IDs or secrets.
qobuz-dj does not publish any of Qobuz's private secrets or app IDs. It contains regular expressions and other code to dynamically grab them from Qobuz's web player's publicly available JavaScript, which is not rehosted, but grabbed client side. Scraping public data is not a violation of the Computer Fraud and Abuse Act (USA) according to the Ninth Court of Appeals, case # 17-16783 (see page 29).
qobuz-dj uses the Qobuz API, but is not endorsed, certified or otherwise approved in any way by Qobuz.
Qobuz brand and name is the registered trademark of its respective owner.
qobuz-dj has no partnership, sponsorship or endorsement with Qobuz.
By using qobuz-dj, you agree to the following: http://static.qobuz.com/apps/api/QobuzAPI-TermsofUse.pdf