qobuz-dl

Seach and download Lossless and Hi-Res music from Qobuz.

If you need help or want to report a problem, join qobuz-dl's discord server.

Features

• Download FLAC and MP3 files from Qobuz
• Search and download music directly from your terminal with interactive or lucky mode
• Download albums, tracks, artists, playlists and labels with download mode
• Queue support on interactive mode
• Support for albums with multiple discs
• Read URLs from text file
• And more

Getting started

qobuz-dl requires Python >3.6

You'll need an active subscription

Install qobuz-dl with pip

Linux / MAC OS / Windows

pip3 install --upgrade qobuz-dl

Run qobuz-dl and enter your credentials

Linux / MAC OS

qobuz-dl

Windows

qobuz-dl.exe

If something fails, run qobuz-dl -r to reset your config file.

Examples

Interactive mode

Run interactive mode with a limit of 10 results

qobuz-dl fun -l 10

Now you can search albums and tracks:

Logging...
Logged: OK
Membership: Studio


Enter your search: [Ctrl + c to quit]
- fka twigs magdalene

Everything else is interactive. Enjoy.

Run qobuz-dl fun --help for more info.

Download mode

Download URL in 24B<96khz quality

qobuz-dl dl https://play.qobuz.com/album/qxjbxh1dc3xyb -q 7

Download multiple URLs to custom directory

qobuz-dl dl https://play.qobuz.com/artist/2038380 https://play.qobuz.com/album/ip8qjy1m6dakc -d "Some pop from 2020"

Download multiple URLs from text file

qobuz-dl dl this_txt_file_has_urls.txt

Download albums from a label and also embed cover art images into the downloaded files

qobuz-dl dl https://play.qobuz.com/label/7526 --embed-art

Download a playlist in maximum quality

qobuz-dl dl https://play.qobuz.com/playlist/5388296 -q 27

Run qobuz-dl dl --help for more info.

Lucky mode

Download the first album result

qobuz-dl lucky playboi carti die lit

Download the first 5 artist results

qobuz-dl lucky joy division -n 5 --type artist

Download the first 3 track results in 320 quality

qobuz-dl lucky eric dolphy remastered --type track -n 3 -q 5

Run qobuz-dl lucky --help for more info.

Other

Reset your config file

qobuz-dl -r

Usage

usage: qobuz-dl [-h] [-r] {fun,dl,lucky} ...

The ultimate Qobuz music downloader.
See usage examples on https://github.com/vitiko98/qobuz-dl

optional arguments:
  -h, --help      show this help message and exit
  -r, --reset     create/reset config file

commands:
  run qobuz-dl <command> --help for more info
  (e.g. qobuz-dl fun --help)

  {fun,dl,lucky}
    fun           interactive mode
    dl            input mode
    lucky         lucky mode

A note about Qo-DL

qobuz-dl is inspired in the discontinued Qo-DL-Reborn. This program uses two modules from Qo-DL: qopy and spoofer, both written by Sorrow446 and DashLt.

Disclaimer

This tool was written for educational purposes. I will not be responsible if you use this program in bad faith. By using it, you are accepting the Qobuz API Terms of Use.