A frontend browser client for downloading music for Qobuz.
Find a file
2025-09-06 01:52:57 +00:00
.forgejo/workflows CI/CD 2025-09-02 19:49:00 -06:00
app Update app/layout.tsx 2025-09-06 01:52:57 +00:00
components Add icons to ReleaseCard artist and album fields 2025-09-01 10:21:34 -06:00
hooks Lint whole project 2025-09-01 09:03:53 -06:00
lib Show toast error when Qobuz provides sample file 2025-09-01 10:12:08 -06:00
public Fix MD5 Hash for FLAC files 2025-03-24 00:34:17 +00:00
.env.build CI/CD 2025-09-02 19:36:16 -06:00
.env.example Ignore all env files by default 2025-09-01 09:02:06 -06:00
.gitignore CI/CD 2025-09-02 19:36:16 -06:00
.prettierignore Use prettier for consistent linting 2025-09-01 09:03:47 -06:00
changelog.json Custom Naming Variables & Reset Settings 2025-07-04 00:35:22 +01:00
components.json Initial commit 2024-12-31 18:59:32 +00:00
docker-compose.yml Create docker-compose.yml 2025-06-18 21:24:38 +03:00
Dockerfile CI/CD 2025-09-02 19:35:08 -06:00
eslint.config.mjs Use prettier for consistent linting 2025-09-01 09:03:47 -06:00
LICENSE Create LICENSE 2025-01-02 00:00:40 +00:00
next.config.ts CI/CD 2025-09-02 19:40:33 -06:00
package-lock.json Use prettier for consistent linting 2025-09-01 09:03:47 -06:00
package.json Use prettier for consistent linting 2025-09-01 09:03:47 -06:00
postcss.config.mjs Initial commit 2024-12-31 18:59:32 +00:00
prettier.config.cjs Use prettier for consistent linting 2025-09-01 09:03:47 -06:00
README.md Update README.md 2025-06-18 21:25:40 +03:00
tailwind.config.ts Lint whole project 2025-09-01 09:03:53 -06:00
tsconfig.json Initial commit 2024-12-31 18:59:32 +00:00

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:

    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.