MCPcopy Index your code
hub / github.com/QobuzDL/Qobuz-DL

github.com/QobuzDL/Qobuz-DL @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
1,749 symbols 5,281 edges 65 files 0 documented · 0% updated 9mo ago★ 90445 open issues

Browse by type

Functions 1,745 Types & classes 4
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Qobuz-DL

Qobuz-DL


[!IMPORTANT] This repository does not contain any copyrighted material, or code to illegaly download music. Downloads are provided by the Qobuz API and should only be initiated by the API token owner. The author is not responsible for the usage of this repository nor endorses it, nor is the author responsible for any copies, forks, re-uploads made by other users, or anything else related to Qobuz-DL. Any live demo found online of this project is not associated with the authors of this repo. This is the author's only account and repository.

Qobuz-DL provides a fast and easy way to download music using Qobuz in a variety of codecs and formats entirely from the browser.

Features

  • Download any song or album from Qobuz.
  • Re-encode audio provided by Qobuz to a variety of different lossless and lossy codecs using FFmpeg.
  • Apply metadata to downloaded songs.

Table of Contents

Installation

Before you begin, ensure you have the following installed:

  • Node.js (LTS version recommended)
    Download from: https://nodejs.org/

  • npm (comes with Node.js)
    To check if npm is installed, run: bash npm -v

Getting Started

1. Clone the repo

git clone https://github.com/QobuzDL/Qobuz-DL.git

2. Navigate to the project directory

cd Qobuz-DL

3. Install Dependencies

npm i

4. Run the development server

npm run dev

Docker Installation

1. Clone the repo

git clone https://github.com/QobuzDL/Qobuz-DL.git

2. Navigate to the project directory

cd Qobuz-DL

3. Dockerfile build

docker build -t qobuz-dl .

4. Docker compose

docker-compose up -d

Setup .env (IMPORTANT)

Before you can use Qobuz-DL, you need to change the .env file in the root directory. The default configuration will NOT work. QOBUZ_APP_ID and QOBUZ_SECRET must be set to the correct values. To find these you can use this tool. Additionally, in order to download files longer than 30 seconds, a valid Qobuz token is needed. This can be found in the localuser.token key of localstorage on the official Qobuz website for any paying members.

Contributing

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature-name.
  3. Make your changes.
  4. Push your branch: git push origin feature-name.
  5. Create a pull request.

License

This project is licensed under the MIT License.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 1,745
Interface 4

Languages

TypeScript100%

Modules by API surface

public/flac/asm/flac.js720 symbols
public/flac/asm/flac.encoder.js684 symbols
public/flac/wasm/flac.js123 symbols
public/flac/wasm/flac.encoder.js123 symbols
lib/qobuz-dl.tsx10 symbols
hooks/use-toast.ts9 symbols
lib/qobuz-dl-server.tsx7 symbols
lib/utils.ts6 symbols
lib/ffmpeg-functions.tsx4 symbols
lib/download-job.tsx4 symbols
components/artist-dialog.tsx4 symbols
app/search-view.tsx4 symbols

For agents

$ claude mcp add Qobuz-DL \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page