mirror of
https://github.com/nathom/streamrip.git
synced 2025-06-01 15:58:24 -04:00
Update README
This commit is contained in:
parent
8852f562a0
commit
76512ad4af
1 changed files with 43 additions and 39 deletions
82
README.md
82
README.md
|
@ -3,9 +3,10 @@
|
||||||
[](https://pepy.tech/project/streamrip)
|
[](https://pepy.tech/project/streamrip)
|
||||||
[](https://github.com/python/black)
|
[](https://github.com/python/black)
|
||||||
|
|
||||||
|
|
||||||
A scriptable stream downloader for Qobuz, Tidal, Deezer and SoundCloud.
|
A scriptable stream downloader for Qobuz, Tidal, Deezer and SoundCloud.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
|
@ -25,6 +26,14 @@ First, ensure [Python](https://www.python.org/downloads/) (version 3.8 or greate
|
||||||
pip3 install streamrip --upgrade
|
pip3 install streamrip --upgrade
|
||||||
```
|
```
|
||||||
|
|
||||||
|
When you type
|
||||||
|
|
||||||
|
```bash
|
||||||
|
rip
|
||||||
|
```
|
||||||
|
|
||||||
|
it should show the main help page.
|
||||||
|
|
||||||
If you would like to use `streamrip`'s conversion capabilities, download TIDAL videos, or download music from SoundCloud, install [ffmpeg](https://ffmpeg.org/download.html). To download music from YouTube, install [youtube-dl](https://github.com/ytdl-org/youtube-dl#installation).
|
If you would like to use `streamrip`'s conversion capabilities, download TIDAL videos, or download music from SoundCloud, install [ffmpeg](https://ffmpeg.org/download.html). To download music from YouTube, install [youtube-dl](https://github.com/ytdl-org/youtube-dl#installation).
|
||||||
|
|
||||||
|
|
||||||
|
@ -35,25 +44,26 @@ If you would like to use `streamrip`'s conversion capabilities, download TIDAL v
|
||||||
Download an album from Qobuz
|
Download an album from Qobuz
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip -u https://open.qobuz.com/album/0060253780968
|
rip url https://www.qobuz.com/us-en/album/rumours-fleetwood-mac/0603497941032
|
||||||
```
|
```
|
||||||
|
|
||||||
Download multiple albums from Qobuz
|
Download multiple albums from Qobuz
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip -u https://www.qobuz.com/us-en/album/back-in-black-ac-dc/0886444889841 -u https://www.qobuz.com/us-en/album/blue-train-john-coltrane/0060253764852
|
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`
|
Download the album and convert it to `mp3`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip --convert mp3 -u https://open.qobuz.com/album/0060253780968
|
rip url --convert mp3 https://open.qobuz.com/album/0060253780968
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
To set the quality, use the `--quality` option to `0, 1, 2, 3, 4`:
|
To set the maximum quality, use the `--max-quality` option to `0, 1, 2, 3, 4`:
|
||||||
|
|
||||||
| Quality ID | Audio Quality | Available Sources |
|
| Quality ID | Audio Quality | Available Sources |
|
||||||
| ---------- | --------------------- | -------------------------------------------- |
|
| ---------- | --------------------- | -------------------------------------------- |
|
||||||
|
@ -65,61 +75,55 @@ To set the quality, use the `--quality` option to `0, 1, 2, 3, 4`:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip --quality 3 https://tidal.com/browse/album/147569387
|
rip url --max-quality 3 https://tidal.com/browse/album/147569387
|
||||||
```
|
```
|
||||||
|
|
||||||
Search for albums matching `lil uzi vert` on SoundCloud
|
Search for albums matching `lil uzi vert` on SoundCloud
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip search -s soundcloud 'lil uzi vert'
|
rip search --source soundcloud 'lil uzi vert'
|
||||||
```
|
```
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
Search for *Rumours* on Tidal, download it, convert it to `ALAC`
|
Search for *Rumours* on Tidal, and download it
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip -c alac search 'fleetwood mac rumours'
|
rip 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)
|
Want to find some new music? Use the `discover` command (only on Qobuz)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
rip discover --list 'best-sellers'
|
rip discover --list 'best-sellers'
|
||||||
```
|
```
|
||||||
|
|
||||||
> Avaiable options for `--list`:
|
Download a last.fm playlist using the lastfm command
|
||||||
>
|
|
||||||
> - most-streamed
|
```
|
||||||
> - recent-releases
|
rip lastfm https://www.last.fm/user/nathan3895/playlists/12126195
|
||||||
> - best-sellers
|
```
|
||||||
> - press-awards
|
|
||||||
> - ideal-discography
|
For extreme customization, see the config file
|
||||||
> - editor-picks
|
|
||||||
> - most-featured
|
```
|
||||||
> - qobuzissims
|
rip config --open
|
||||||
> - new-releases
|
```
|
||||||
> - new-releases-full
|
|
||||||
> - harmonia-mundi
|
|
||||||
> - universal-classic
|
|
||||||
> - universal-jazz
|
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 `-h` flag. For example, to see the help page for the `url` command, type
|
||||||
> - universal-jeunesse
|
|
||||||
> - universal-chanson
|
```
|
||||||
|
rip url -h
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## Other information
|
## Other information
|
||||||
|
|
||||||
For more in-depth information about `streamrip`, see the [wiki](https://github.com/nathom/streamrip/wiki/).
|
For more in-depth information about `streamrip`, see the help pages and the [wiki](https://github.com/nathom/streamrip/wiki/).
|
||||||
|
|
||||||
|
|
||||||
## Contributions
|
## Contributions
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue