← Projects
Open source

qobuz-cli

Command-line interface for Qobuz — search, library, and quick-open in the app

Documentation →GitHub ↗

Features

  • Fast search & metadata — search albums, tracks, and artists; inspect album, artist, and track details.
  • Library & playlists — list, add, and remove favourites; list, show, create, and edit playlists.
  • Collection stats — qobuz stats shows your genre mix, hi-res ratio, and top artists/labels from the local desktop library.
  • Media-key playback control — play, next, previous, forward, and rewind drive the Qobuz desktop app via real media keys (macOS, requires Accessibility permission).
  • Quick open & copy — open deep-links straight into the Qobuz app; url (alias copy-url) copies a link to the clipboard — bare qobuz url copies the currently-playing track.
  • Secure login — stores a browser-borrowed token in the macOS Keychain; no password handling.

Install

npm install -g @kud/qobuz-cli

Usage

$ qobuz login                      # connect (opens browser, paste app_id + token)
$ qobuz search "radiohead"
$ qobuz album 0634904032432
$ qobuz fav list
$ qobuz playlist create "Focus"
$ qobuz stats                      # collection analytics from the desktop library
$ qobuz play                       # toggle play/pause in Qobuz
$ qobuz next                       # skip track (also: previous, forward, rewind)
$ qobuz open album 0634904032432   # open in the Qobuz app
$ qobuz url                        # copy the currently-playing track's link
$ qobuz url album 0634904032432    # copy a specific item's deep link
$ qobuz url --plain                # print the bare URL (no clipboard) for scripting

Full command set: login, logout, search, album, artist, track, similar, fav (list/add/remove), playlist (list/show/create/add/remove), stats, url / copy-url, open, play, next, previous / prev, forward / ff, rewind / rew.

macOS note — playback commands (play, next, previous, forward, rewind) use real media keys and require Accessibility permission granted to your terminal. The first playback command compiles a small Swift helper via swiftc.

Development

git clone https://github.com/kud/qobuz-cli.git
cd qobuz-cli
npm install
npm run dev -- search "radiohead"   # run from source via tsx
npm run build
npm run typecheck