Features
- Interactive TUI — full-screen terminal UI (Ink/React): type to search, arrow-key navigate, drill into detail, act. Launched with bare
qobuzorqobuz tui. Works on macOS and Linux. - 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 statsshows your genre mix, hi-res ratio, and top artists/labels from the local desktop library. - Media-key playback control —
play,next,previous,forward, andrewinddrive the Qobuz desktop app via real media keys (macOS, requires Accessibility permission). - Quick open & copy —
opendeep-links straight into the Qobuz app;url(aliascopy-url) copies a link to the clipboard — bareqobuz urlcopies the currently-playing track. - Secure login — stores a browser-borrowed token in the macOS Keychain; no password handling.
Install
npm install -g @kud/qobuz-cliTUI mode
Run qobuz (no arguments) or qobuz tui to open the interactive full-screen interface — "Raycast in the terminal". The TUI requires an interactive terminal (TTY) and works on both macOS and Linux.
Views
| View | What it shows |
|---|---|
| Home | Palette — Search, Favourites, Playlists, Now Playing |
| Search | Live results sectioned into Tracks, Albums, Artists (debounced, ≥ 2 chars) |
| Favourites | Your starred tracks |
| Playlists | Playlist list → Tracklist (read-only) |
| Detail — Track | Title, artist, album, duration, Hi-Res flag |
| Detail — Album | Title, artist, release date, genre, track count, Hi-Res flag |
| Detail — Artist | Album count + navigable similar-artists list |
| Convert | Qobuz track → Deezer / Spotify / YouTube links |
| Now Playing | Currently playing track info |
Keybindings
| Key | Action |
|---|---|
| type | Search (in Search view) |
↑ / ↓ or j / k | Navigate list |
↵ | Open / drill into item |
Esc or Backspace | Back (quit from root) |
q | Quit |
o | Open current item in Qobuz app (Detail views) |
c | Convert track to streaming links (Track detail) |
space | Toggle play/pause (macOS only) |
n | Next track (macOS only) |
p | Previous track (macOS only) |
Usage
$ qobuz # open interactive TUI
$ qobuz tui # same — explicit subcommand
$ 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
$ qobuz convert <track-url> # convert a Qobuz track URL to streaming links
$ qobuz now-playing # show the currently-playing track (alias: np)Full command set: tui, login, logout, search, album, artist, track, similar, fav (list/add/remove), playlist (list/show/create/add/remove), convert, now-playing / np, stats, url / copy-url, open, play, next, previous / prev, forward / ff, rewind / rew.
macOS note — playback commands (
play,next,previous,forward,rewind) and TUI playback keys (space,n,p) use real media keys and require Accessibility permission granted to your terminal. The first playback command compiles a small Swift helper viaswiftc.
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 dev # run TUI from source
npm run build
npm run typecheck📚 Full documentation → qobuz-cli/docs
Disclaimer
This is an independent, unofficial project — not affiliated with, endorsed by, or sponsored by Qobuz. "Qobuz", the Qobuz logo, and any icons derived from it are trademarks of Qobuz Music, used here only to indicate compatibility.