Metadata-Version: 2.1
Name: streamrip
Version: 0.2.5
Summary: A stream downloader for Qobuz, Tidal, and Deezer.
Home-page: UNKNOWN
Author: Nathan
Author-email: nathanthomas707@gmail.com
License: UNKNOWN
Project-URL: Source, https://github.com/nathom/streamrip
Project-URL: Bug Reports, https://github.com/nathom/streamrip/issues
Keywords: lossless,hi-res,qobuz,tidal,deezer,audio,convert
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: tidalapi
Requires-Dist: dogpile.cache
Requires-Dist: ruamel.yaml
Requires-Dist: pathvalidate
Requires-Dist: requests
Requires-Dist: mutagen
Requires-Dist: tqdm
Requires-Dist: simple-term-menu
Requires-Dist: colorama

# streamrip

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



## Installation

```bash
pip3 install streamrip
```



## Basic Usage

**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
```

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
```

```bash
rip config --help
```

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



