orpheusdl-deezer/README.md

# orpheusdl-deezer
[OrpheusDL](https://github.com/yarrm80s/orpheusdl) module for downloading music from [Deezer](https://www.deezer.com/)

## Fork description

Thanks to [uhwot](https://github.com/uhwot/orpheusdl-deezer), the original project that made this possible!

<!-- As of Aug 2, 2023 -->
What's changed?

- Better README.md
- Login with ARL Token
- `bf_secret` and `track_url_key` easily acessible
- AGPL-3.0 license
<!--  -->

## QA

> Isn't ARL Token only used for piracy?

Many people believe that, even the official developer (that's the reason he/she did not implement ARL login themselves).

That is **incorrect**. There are many legitimate uses for it. As an example, people might [share an account and use the token to login](https://github.com/uhwot/orpheusdl-deezer/issues/5#issue-1740410158).

> So, you support piracy?

No\
If you want to use this module for illegitimate purposes, that's your problem. This is not made for this purpose, and I do not support it.

> Uh, you got a token bro?

Sure, find one here:\
[deezer.com/offers](https://www.deezer.com/offers)

Again, I'm not facilitating piracy. Issues or discussions related to pirated use will not be accepted, since the focus is legitimate use cases only.

# Getting started
## Prerequisites
- [OrpheusDL](https://github.com/yarrm80s/orpheusdl)
- [Git](https://git-scm.com/downloads)
- [Python](https://www.python.org/)

## Installation
1. Clone the repository from your `orpheusdl` directory:\
`git clone https://github.com/nanometer5088/orpheusdl-deezer modules/deezer`

2. Create the settings file:\
`python3 orpheus.py settings refresh`

3. Update `config/settings.json` with your Deezer ARL Token:\
`python orpheus.py`

4. Include `bf_secret` and `track_url_key` from the [mirrors](#mirrors)


# Mirrors

`bf_secret` and `track_url_key` cannot be included in the code.

You can find their correct values on any of the mirrors below:

- [gist.github.com](https://gist.github.com/ovosimpatico/03dc3a4677e11f8f262e96a6bd5a5628)
- [rentry.org](https://rentry.org/1_nanometer5088_orpheusdl-deezer)
- [rentry.co](https://rentry.co/1_nanometer5088_orpheusdl-deezer)
- [pixeldrain.com](https://pixeldrain.com/u/z4Np7DQ2)
- [pastebin.com](https://pastebin.com/1gjsfVW6)
- [notebin.de](https://notebin.de/?8f5fad49c83dbe47#7vWVe3oxjMtytNJNM7PdSrNvJfgDSMuUex64TqnuCUhS)


# Configuration
## Global
```download_quality```:
| Value      | Format                                                                       |
| ---------- | ---------------------------------------------------------------------------- |
| "hifi"     | 16-bit 44.1kHz FLAC / 360RA if available and ```spatial_codecs``` is enabled |
| "lossless" | 16-bit 44.1kHz FLAC                                                          |
| "high"     | MP3 320kbps                                                                  |
| "medium"   | MP3 320kbps                                                                  |
| "low"      | MP3 128kbps                                                                  |
| "minimum"  | MP3 128kbps                                                                  |

```spatial_codecs```:\
Enables 360RA downloads if ```download_quality``` is set to ```hifi```

```main_resolution```:\
Maxes out at 3000px\
If original cover size is smaller than the one specified, falls back to 1200px

## Deezer
| Setting         | Description                                         |
| --------------- | --------------------------------------------------- |
| `client_id`     | Client ID used for login                            |
| `client_secret` | Client secret used for login                        |
| `bf_secret`     | Constant for deriving key used for track decryption |
| `track_url_key` | Key used for legacy track URL generation            |
| `prefer_mhm1`   | Downloads MHM1 360RA formats instead of MHA1        |
| `arl`           | Account token used to login without user/pass       |
| `username`      | **DO NOT MODIFY - LOGIN WITHOUT ARL IS DISABLED**   |
| `password`      | **DO NOT MODIFY - LOGIN WITHOUT ARL IS DISABLED**   |