qobuz-cli

๐Ÿ“š Library

Manage your Qobuz favourites and playlists from the terminal

These commands read and write your account: favourites (albums, artists, tracks) and full playlist management. They need a connected session (see Authentication).

โญ Favourites โ€” qobuz fav

qobuz fav list [--type albums|artists|tracks]

Lists your favourites. --type selects the category (default albums).

$ qobuz fav list --type albums
  0634904032432  Radiohead โ€” OK Computer
  0060253764352  Aphex Twin โ€” Selected Ambient Works

qobuz fav add <type> <id>

Adds an item to favourites. <type> is albums, artists, or tracks; <id> is that item's id.

$ qobuz fav add albums 0634904032432
โœ“ added albums 0634904032432 to favourites

qobuz fav remove <type> <id>

Removes an item from favourites.

$ qobuz fav remove albums 0634904032432
โœ“ removed albums 0634904032432 from favourites

๐Ÿ“ Playlists โ€” qobuz playlist

qobuz playlist list

Your playlists, with track counts.

$ qobuz playlist list
  65996412  Focus       (24 tracks)
  65996501  Late nights (11 tracks)

qobuz playlist show <id>

A single playlist's name, description, and a deep link. <id> is the playlist number.

$ qobuz playlist show 65996412
Focus  (24 tracks)
Instrumental, no lyrics.
open: https://open.qobuz.com/playlist/65996412

qobuz playlist create <name> [--public]

Creates a playlist (private by default; pass --public to make it public) and prints its new id.

$ qobuz playlist create "Focus"
โœ“ created playlist "Focus" [65996412]

$ qobuz playlist create "Shared mix" --public
โœ“ created playlist "Shared mix" [65996777]

qobuz playlist add <playlistId> <trackId>

Adds a track to a playlist. Both arguments are numbers.

$ qobuz playlist add 65996412 33933680
โœ“ added track 33933680 to playlist 65996412

qobuz playlist remove <id>

โš ๏ธ This deletes the entire playlist โ€” not a track within it. There is no "remove a track from a playlist" command in the CLI today; remove maps to deleting the whole playlist. Double-check the id before running it.

$ qobuz playlist remove 65996412
โœ“ deleted playlist 65996412

๐Ÿ“Š Collection stats โ€” qobuz stats

Analytics about your library, computed from the Qobuz desktop app's local database โ€” no account call, no auth. macOS only.

$ qobuz stats --limit 6
Collection: 543 albums ยท 401 artists ยท 699 offline tracks ยท 3055 saved tracks

Quality (offline tracks)
  16-bit  507  72.5%
  24-bit  192  27.5%

Top genres
  Rock                 585
  Alternative & Indie  576
  Metal                484
  โ€ฆ

Top artists (by albums)
  In Flames          10
  Killswitch Engage  8
  โ€ฆ

Added recently
  2026-06  51
  2026-05  66
  โ€ฆ

--limit caps each breakdown (default 10). Quality and top-artists come from your offline/downloaded tracks; genres and labels from your broader saved library. If the Qobuz desktop app isn't installed, it prints No Qobuz library found.

On this page