added readme

This commit is contained in:
uh wot
2022-07-22 14:54:25 +02:00
parent c040a0e61b
commit 628609be64

41
README.md Normal file
View File

@@ -0,0 +1,41 @@
# orpheusdl-deezer
[OrpheusDL](https://github.com/yarrm80s/orpheusdl) module for downloading music from [Deezer](https://www.deezer.com/)
# Getting started
## Prerequisites
- [OrpheusDL](https://github.com/yarrm80s/orpheusdl), duh
## Installation
- Clone the repository from your ```orpheusdl``` directory:\
```git clone https://github.com/uhwot/orpheusdl-deezer modules/deezer```
- Update ```config/settings.json``` with Deezer settings:\
```python orpheus.py```
# 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 |
| `email` | Account email |
| `password` | Account password |