qobuz-dl/README.md

61 lines
1.9 KiB
Markdown
Raw Normal View History

2020-08-10 04:47:51 +02:00
# Qobuz-DL
Seach and download Lossless and Hi-Res music from [Qobuz](https://www.qobuz.com/)
![Demostration](demo.gif)
2020-08-13 06:52:16 +02:00
> This is a GIF from the first release. After the first release, some new features like **queue** and **MP3** support were added.
2020-08-10 04:47:51 +02:00
## Features
2020-08-13 06:52:16 +02:00
* Download FLAC and MP3 files from Qobuz
2020-08-10 04:47:51 +02:00
* Forget about links: just search and download music directly from your terminal
2020-08-13 06:52:16 +02:00
* Queue support
2020-08-10 04:47:51 +02:00
* If you still want links, `Qobuz-DL` also has an input url mode
## Getting started
> Note: `Qobuz-DL` requires Python >3.6
> Note 2: You'll need an **active subscription**
#### Install requirements with pip
##### Linux / MAC OS
```
pip3 install -r requirements.txt --user
```
##### Windows 10
```
pip3 install windows-curses
pip3 install -r requirements.txt
```
2020-11-03 00:48:48 +01:00
#### Add your credentials to `config.py`
```python
email = "your@email.com"
password = "your_password"
2020-08-10 04:47:51 +02:00
```
#### Run Qobuz-DL
##### Linux / MAC OS
```
python3 main.py
```
##### Windows 10
```
python.exe main.py
```
## Usage
```
usage: python3 main.py [-h] [-a] [-i] [-q int] [-l int] [-d PATH]
optional arguments:
2020-11-03 00:55:37 +01:00
-h, --help show this help message and exit
-a enable albums-only search
-i Album/track URL run Qobuz-Dl on URL input mode (download by url)
-q int quality (5, 6, 7, 27) (default: 6) [320, LOSSLESS, 24B <96KHZ, 24B >96KHZ]
-l int limit of search results by type (default: 10)
-d PATH custom directory for downloads (default: 'Qobuz Downloads')
2020-08-10 04:47:51 +02:00
```
## A note about Qo-DL
`Qobuz-DL` is inspired in the discontinued Qo-DL-Reborn. This program uses two modules from Qo-DL: `qopy` and `spoofer`, both written by Sorrow446 and DashLt.
## Disclaimer
This tool was written for educational purposes. I will not be responsible if you use this program in bad faith.
2020-08-13 06:52:16 +02:00
Also, you are accepting this: https://static.qobuz.com/apps/api/QobuzAPI-TermsofUse.pdf