mirrors
/
streamrip
mirror of https://github.com/nathom/streamrip.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
A scriptable music downloader for Qobuz, Tidal, SoundCloud, and Deezer
69 Commits 6 Branches 54 Tags 8.5 MiB
Python 100%
Go to file
nathom 12d64e95b2
Delete python-publish2.yml 		2021-03-29 18:10:50 -07:00
.github/workflows Delete python-publish2.yml 2021-03-29 18:10:50 -07:00
demo Added README 2021-03-25 11:19:12 -07:00
streamrip Added support for Tidal artists 2021-03-29 18:00:14 -07:00
.flake8 initial commit 2021-03-22 09:21:27 -07:00
.gitignore Update .gitignore 2021-03-28 20:03:29 -07:00
.isort.cfg initial commit 2021-03-22 09:21:27 -07:00
LICENSE initial commit 2021-03-22 09:21:27 -07:00
README.md Update README 2021-03-29 16:02:33 -07:00
requirements.txt Remove tidalapi from requirements.txt 2021-03-29 12:13:53 -07:00
setup.py Added support for Tidal artists 2021-03-29 18:00:14 -07:00

README.md

streamrip

A scriptable stream downloader for Qobuz, Tidal, and Deezer.

Features

  • 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

Installation

First, ensure pip is installed. Then run the following in the command line:

pip3 install streamrip --upgrade

If you would like to use streamrip's conversion capabilities, install ffmpeg.

Example Usage

For Tidal and Qobuz, you NEED a premium subscription.

Download an album from Qobuz

rip -u https://open.qobuz.com/album/0060253780968

Download the album and convert it to mp3

rip --convert mp3 -u https://open.qobuz.com/album/0060253780968

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 (CD) Deezer, Tidal, Qobuz
3 24 bit, ≤ 96 kHz Tidal (MQA), Qobuz
4 24 bit, ≤ 192 kHz Qobuz 
rip --quality 3 https://tidal.com/browse/album/147569387

Search for Fleetwood Mac - Rumours on Qobuz

rip search 'fleetwood mac rumours'

streamrip interactive search

Search for Rumours on Tidal, download it, convert it to ALAC

rip -c alac search 'fleetwood mac rumours'

Qobuz discographies can be filtered using the filter subcommand

rip filter --repeats --features 'https://open.qobuz.com/artist/22195'

Want to find some new music? Use the discover command (only on Qobuz)

rip discover --list 'best-sellers'

Avaiable options for --list:

  • most-streamed
  • recent-releases
  • best-sellers
  • press-awards
  • ideal-discography
  • editor-picks
  • most-featured
  • qobuzissims
  • new-releases
  • new-releases-full
  • harmonia-mundi
  • universal-classic
  • universal-jazz
  • universal-jeunesse
  • universal-chanson

For more help and examples

rip --help

rip filter --help

rip search --help

rip discover --help

rip config --help

This tool is still in development. If there are any features you would like to see, please open an issue.

Acknowledgements

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:

Disclaimer

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.