2021-03-25 14:19:12 -04:00
|
|
|
# streamrip
|
|
|
|
|
|
|
|
A scriptable stream downloader for Qobuz, Tidal, and Deezer.
|
|
|
|
|
2021-03-29 17:08:26 -04:00
|
|
|
## Features
|
2021-03-25 14:19:12 -04:00
|
|
|
|
2021-03-29 17:08:26 -04:00
|
|
|
- Downloads tracks, albums, playlists, discographies, and labels from Qobuz, Tidal, and Deezer
|
|
|
|
|
|
|
|
- Automatically converts files to a preferred format
|
|
|
|
- Has a database that stores the downloaded tracks' IDs so that repeats are avoided
|
|
|
|
- Easy to customize with the config file
|
2021-03-25 14:19:12 -04:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
2021-03-29 17:08:26 -04:00
|
|
|
First, ensure [pip](https://pip.pypa.io/en/stable/installing/) is installed.
|
|
|
|
|
2021-03-25 14:19:12 -04:00
|
|
|
```bash
|
2021-03-28 23:54:23 -04:00
|
|
|
pip3 install streamrip --upgrade
|
2021-03-25 14:19:12 -04:00
|
|
|
```
|
|
|
|
|
2021-03-29 17:08:26 -04:00
|
|
|
If you would like to use `streamrip`'s conversion capabilities, install [ffmpeg](https://ffmpeg.org/download.html).
|
2021-03-25 14:19:12 -04:00
|
|
|
|
2021-03-29 17:08:26 -04:00
|
|
|
## Example Usage
|
2021-03-25 14:19:12 -04:00
|
|
|
|
|
|
|
**For Tidal and Qobuz, you NEED a premium subscription.**
|
|
|
|
|
|
|
|
Download an album from Qobuz
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip -u https://open.qobuz.com/album/0060253780968
|
|
|
|
```
|
|
|
|
|
|
|
|
Download the album and convert it to `mp3`
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip --convert mp3 -u https://open.qobuz.com/album/0060253780968
|
|
|
|
```
|
|
|
|
|
2021-03-29 15:12:50 -04:00
|
|
|
To set the quality, use the `--quality` option to `0, 1, 2, 3, 4`:
|
|
|
|
|
|
|
|
| Quality ID | Audio Quality | Available Sources |
|
|
|
|
| ---------- | ------------------- | -------------------- |
|
|
|
|
| 0 | 128 kbps MP3 or AAC | Deezer, Tidal |
|
|
|
|
| 1 | 320 kbps MP3 or AAC | Deezer, Tidal, Qobuz |
|
|
|
|
| 2 | 16 bit / 44.1 kHz | Deezer, Tidal, Qobuz |
|
|
|
|
| 3 | 24 bit / ≤ 96 kHz | Tidal (MQA), Qobuz |
|
|
|
|
| 4 | 24 bit / ≤ 192 kHz | Qobuz |
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip --quality 3 https://tidal.com/browse/album/147569387
|
|
|
|
```
|
|
|
|
|
2021-03-25 14:19:12 -04:00
|
|
|
Search for *Fleetwood Mac - Rumours* on Qobuz
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip search 'fleetwood mac rumours'
|
|
|
|
```
|
|
|
|
|
|
|
|
![streamrip interactive search](demo/interactive_search.png)
|
|
|
|
|
|
|
|
Search for *Rumours* on Tidal, download it, convert it to `ALAC`
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip -c alac search 'fleetwood mac rumours'
|
|
|
|
```
|
|
|
|
|
|
|
|
Qobuz discographies can be filtered using the `filter` subcommand
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip filter --repeats --features 'https://open.qobuz.com/artist/22195'
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Want to find some new music? Use the `discover` command (only on Qobuz)
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip discover --list 'best-sellers'
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For more help and examples
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip --help
|
|
|
|
```
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip filter --help
|
|
|
|
```
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip search --help
|
|
|
|
```
|
|
|
|
|
|
|
|
```bash
|
|
|
|
rip discover --help
|
|
|
|
```
|
|
|
|
|
2021-03-25 15:11:57 -04:00
|
|
|
```bash
|
|
|
|
rip config --help
|
|
|
|
```
|
|
|
|
|
2021-03-25 14:19:12 -04:00
|
|
|
**This tool is still in development. If there are any features you would like to see, please open an issue.**
|
|
|
|
|