A scriptable stream downloader for Qobuz, Tidal, Deezer and SoundCloud.
- Fast, concurrent downloads powered by
aiohttp
- Downloads tracks, albums, playlists, discographies, and labels from Qobuz, Tidal, Deezer, and SoundCloud
- Supports downloads of Spotify and Apple Music playlists through last.fm
- Automatically converts files to a preferred format
- Has a database that stores the downloaded tracks' IDs so that repeats are avoided
- Concurrency and rate limiting
- Interactive search for all sources
- Highly customizable through the config file
- Integration with
youtube-dl
First, ensure Python (version 3.10 or greater) and pip are installed. Then install ffmpeg
. You may choose not to install this, but some functionality will be limited.
pip3 install streamrip --upgrade
When you type
rip
it should show the main help page. If you have no idea what these mean, or are having other issues installing, check out the detailed installation instructions.
For Arch Linux users, an AUR package exists. Make sure to install required packages from the AUR before using makepkg
or use an AUR helper to automatically resolve them.
git clone https://aur.archlinux.org/streamrip.git
cd streamrip
makepkg -si
or
paru -S streamrip
If you want to get access to the latest and greatest features without waiting for a new release, install
from the dev
branch with the following command
pip3 install git+https://github.com/nathom/streamrip.git@dev
For Tidal and Qobuz, you NEED a premium subscription.
Download an album from Qobuz
rip url https://www.qobuz.com/us-en/album/rumours-fleetwood-mac/0603497941032
Download multiple albums from Qobuz
rip url https://www.qobuz.com/us-en/album/back-in-black-ac-dc/0886444889841 https://www.qobuz.com/us-en/album/blue-train-john-coltrane/0060253764852
Download the album and convert it to mp3
rip --codec mp3 url https://open.qobuz.com/album/0060253780968
To set the maximum 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, SoundCloud (most of the time) |
1 | 320 kbps MP3 or AAC | Deezer, Tidal, Qobuz, SoundCloud (rarely) |
2 | 16 bit, 44.1 kHz (CD) | Deezer, Tidal, Qobuz, SoundCloud (rarely) |
3 | 24 bit, ≤ 96 kHz | Tidal (MQA), Qobuz, SoundCloud (rarely) |
4 | 24 bit, ≤ 192 kHz | Qobuz |
rip --quality 3 url https://tidal.com/browse/album/147569387
Using
4
is generally a waste of space. It is impossible for humans to perceive the difference between sampling rates higher than 44.1 kHz. It may be useful if you're processing/slowing down the audio.
Search for playlists matching rap
on Tidal
rip search tidal playlist 'rap'
Search for Rumours on Tidal, and download it
rip search tidal album 'fleetwood mac rumours'
Download a last.fm playlist using the lastfm command
rip lastfm https://www.last.fm/user/nathan3895/playlists/12126195
For more customization, see the config file
rip config open
If you're confused about anything, see the help pages. The main help pages can be accessed by typing rip
by itself in the command line. The help pages for each command can be accessed with the --help
flag. For example, to see the help page for the url
command, type
rip url --help
For more in-depth information about streamrip
, see the help pages and the wiki.
All contributions are appreciated! You can help out the project by opening an issue or by submitting code.
If you're opening an issue use the Feature Request or Bug Report templates properly. This ensures that I have all of the information necessary to debug the issue. If you do not follow the templates, I will silently close the issue and you'll have to deal with it yourself.
If you're new to Git, follow these steps to open your first Pull Request (PR):
- Fork this repository
- Clone the new repository
- Commit your changes
- Open a pull request to the
dev
branch
Please document any functions or obscure lines of code.
To help out streamrip
users that may be having trouble, consider contributing some information to the wiki.
Nothing is too obvious and everything is appreciated.
Thanks to Vitiko98, Sorrow446, and DashLt for their contributions to this project, and the previous projects that made this one possible.
streamrip
was inspired by:
I will not be responsible for how you use streamrip
. By using streamrip
, you agree to the terms and conditions of the Qobuz, Tidal, and Deezer APIs.
Consider becoming a Github sponsor for me if you enjoy my open source software.