# Install streamrip with Homebrew, Nix, scoop

Scriptable music downloader for Qobuz, Tidal, SoundCloud, and Deezer. Version 2.1.0 via Homebrew; verified 2026-08-04. Also installable with nix: nix profile install nixpkgs#streamrip.

## Install

```sh
sudo av install brew:streamrip
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install streamrip
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#streamrip
```

  Evidence: nixpkgs package indexes: pkgs/by-name/st/streamrip/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/rip
```

  Evidence: Scoop official bucket manifest trees: bucket/rip.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:streamrip
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/streamrip>
- **Version:** 2.1.0
- **Source summary:** Scriptable music downloader for Qobuz, Tidal, SoundCloud, and Deezer
- **Homepage:** <https://github.com/nathom/streamrip>
- **Repository:** <https://github.com/nathom/streamrip>
- **License:** GPL-3.0-only
- **Source archive:** <https://files.pythonhosted.org/packages/b8/c9/6997772e0217f3081e4e692c7b8b104aaa564c008f2593341e81bbbd2396/streamrip-2.1.0.tar.gz>
- **Last updated:** 2026-08-04T13:13:39Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- rip (cli)
- rip (alias)

## Dependencies

- certifi
- cffi
- ffmpeg
- pillow
- python@3.14

## Uses from macOS

- libffi

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 2.1.0
- Package-manager updated: 2026-08-04
- Local data: ok
- Upstream repository: https://github.com/nathom/streamrip
- info: No cached GitHub release or tag data was available.
## Project history and usage

streamrip is a Python command-line music downloader for services such as Qobuz, Tidal, Deezer, and SoundCloud. It sits in the package-manager world as a scriptable media CLI whose usefulness depends on fast updates to service integrations and authentication behavior.

### Project history

PyPI records streamrip releases beginning with version 0.1 on March 25, 2021. The current project metadata describes it as a fast, all-in-one music downloader for Qobuz, Deezer, Tidal, and SoundCloud.

The GitHub README describes the project as scriptable and highlights concurrent downloads with aiohttp, downloads of tracks/albums/playlists/discographies/labels, last.fm playlist support, conversion, a local database of downloaded track IDs, interactive search, and config-file customization.

### Adoption history

streamrip's README documents pip installation, direct installation from the dev branch, Arch/AUR installation, and Homebrew installation. The supplied package facts also list Nix and Scoop, showing adoption beyond Python packaging alone.

Its user base overlaps with command-line audio collectors who want reproducible download commands, quality selection, metadata control, and service-specific authentication stored in a config file.

### How it is used

The README shows the rip command as the main entry point, with examples for downloading Qobuz and Tidal albums, choosing quality levels, searching Tidal, downloading last.fm playlists, and opening the config with rip config open.

For Tidal and Qobuz, the README states that a premium subscription is needed. The source config includes fields for service credentials and tokens, including Qobuz credentials, Tidal tokens, and a Deezer ARL cookie.

### Why package nerds care

streamrip is package-nerd significant because it turns a messy set of streaming-service workflows into a reproducible CLI interface with config, database, conversion, and metadata behavior.

It also shows the maintenance burden of media download tools in package managers: packaged versions need to track upstream service API changes, Python dependency constraints, and platform-specific config paths.

### Timeline

- 2021-03-25: PyPI release 0.1 uploaded.
- 2024-01-10: GitHub release streamrip v2.0.1 announced as a major release.
- 2025-03-10: PyPI release 2.1.0 uploaded.
- 2026: Homebrew, Nix, and Scoop package-manager entries are present in source_facts.package-manager.

### Related projects

- The README says streamrip was inspired by qobuz-dl, Qo-DL Reborn, Tidal-Media-Downloader, and scdl.
- It integrates with ffmpeg for conversion and mentions youtube-dl integration in its feature list.

### Sources

- <https://github.com/nathom/streamrip#readme>
- <https://github.com/nathom/streamrip/blob/dev/streamrip/config.py>
- <https://pypi.org/project/streamrip/>
- source_facts.package-manager


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ${XDG_CONFIG_HOME:-${HOME}/.config}/streamrip/config.toml
- macOS: ${HOME}/Library/Application Support/streamrip/config.toml
- Windows: %APPDATA%\streamrip\config.toml

## Credential files

- Linux: ${XDG_CONFIG_HOME:-${HOME}/.config}/streamrip/config.toml
- macOS: ${HOME}/Library/Application Support/streamrip/config.toml
- Windows: %APPDATA%\streamrip\config.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** streamrip
- **Version Scheme:** 0
- **Revision:** 11
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - streamrip: normalized package name match | nixpkgs package indexes: pkgs/by-name/st/streamrip/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Scoop - main/rip: installed executable or alias match | Scoop official bucket manifest trees: bucket/rip.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://pkg.so/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://pkg.so/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [ffmpeg](https://pkg.so/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [cffi](https://pkg.so/brew/cffi/) - Runtime dependency declared by Homebrew.
- [yt-dlp](https://pkg.so/brew/yt-dlp/) - Shares pkgdb curated category or tags: audio, cli, downloader, media.
- [aubio](https://pkg.so/brew/aubio/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [csound](https://pkg.so/brew/csound/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [bandcamp-dl](https://pkg.so/brew/bandcamp-dl/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [timidity](https://pkg.so/brew/timidity/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [dzr](https://pkg.so/brew/dzr/) - Shares pkgdb curated category or tags: cli, deezer, media, music.
- [bpm-tools](https://pkg.so/brew/bpm-tools/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [waon](https://pkg.so/brew/waon/) - Shares pkgdb curated category or tags: audio, cli, media, music.
- [scdl](https://pkg.so/brew/scdl/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cffi, cli, downloader, ffmpeg.
- [gamdl](https://pkg.so/brew/gamdl/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, downloader, media, music.

## Combined YAML source

View the package source record on GitHub. [combined/streamrip.yml](https://github.com/mxcl/pkgdb/blob/main/combined/streamrip.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
