👋 Introduction
Reverse-engineered Qobuz API client for Node.js — typed search, metadata, library, playlists, and deep links
@kud/qobuz is a typed, ESM-only client for the (reverse-engineered) Qobuz v0.2 API. It wraps authentication, search, rich metadata, full favourites and playlist management, deep links into the Qobuz apps, reading the desktop app's now-playing track, and collection analytics from its local library — returning clean camelCase domain types, with zero runtime dependencies. It's the shared core that @kud/qobuz-cli builds on.
🔑 How authentication works
Qobuz has no public API and guards login behind a captcha, so @kud/qobuz never
handles passwords. Instead you give it a user_auth_token borrowed from a
logged-in browser session, and a pluggable credential store keeps it — in-memory,
the macOS Keychain, or your own implementation. Every request rides on that
token; the library never sees a password.
📦 Install
npm install @kud/qobuz📖 What's here
- 🔐 Authentication — get a token, choose a credential store, and construct the client.
- 📖 Reference — the full method surface: search, albums, artists, tracks, playlists, and favourites.
- 📦 Resources — the typed domain models each method returns, plus the deep-link helpers.