whatisgithub

What is streamrip?

nathom/streamrip — explained in plain English

Analysis updated 2026-06-26

4,643PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A command-line tool for downloading music from Qobuz, Tidal, Deezer, and SoundCloud, supporting everything from compressed audio up to 24-bit high-resolution files and full artist discographies.

Mindmap

mindmap
  root((streamrip))
    Supported Sources
      Qobuz
      Tidal
      Deezer
      SoundCloud
    Audio Quality
      128kbps compressed
      CD quality 16bit
      Hi-Res 24bit 192kHz
    Features
      Concurrent downloads
      Download database
      Spotify playlist import
    Setup
      Python 3.10 plus
      ffmpeg required
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Download a full artist discography from Tidal or Qobuz in high-resolution audio to your computer

USE CASE 2

Save a Spotify or Apple Music playlist by routing it through a supported service like Deezer or Qobuz

USE CASE 3

Batch download albums concurrently with automatic deduplication so already-downloaded tracks are skipped

USE CASE 4

Configure output folder layout and file naming to match your local music library structure

What is it built with?

Pythonffmpeg

How does it compare?

nathom/streamripmichael-lazar/rtvkozea/radicale
Stars4,6434,6474,648
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10 or later plus ffmpeg installed separately, highest quality downloads also need a paid Qobuz or Tidal subscription.

So what is it?

Streamrip is a command-line tool for downloading music from Qobuz, Tidal, Deezer, and SoundCloud. You give it a link to a track, album, playlist, or an artist's full discography, and it downloads the files to your computer. It also integrates with youtube-dl for additional sources. The tool supports multiple audio quality levels, ranging from compressed 128 kbps files up to 24-bit, 192 kHz high-resolution audio. The highest quality options require a paid subscription on Qobuz or Tidal. The README notes that anything above CD quality (16-bit, 44.1 kHz) is generally a waste of storage space since humans cannot hear the difference at higher sampling rates. You can tell the tool which quality level you want using a number from 0 to 4 when running a command. Streamrip can also download Spotify and Apple Music playlists indirectly, by pulling the track list through last.fm and then downloading those tracks from supported sources. It keeps a local database of what it has already downloaded so it does not download the same track twice. Downloads run concurrently, meaning multiple files are pulled at once to speed things up. Installing requires Python 3.10 or later, plus a tool called ffmpeg for file conversion. Once installed, the main command is simply rip. You can search for music interactively, download by pasting a URL, or open a config file to customize behavior like output format, folder layout, and rate limits. A wiki with detailed instructions is available for people who run into trouble during setup. The project is open to contributions via pull requests to the development branch. The author asks that bug reports follow the provided templates, and notes that issues submitted without following those templates will be closed without response.

Copy-paste prompts

Prompt 1
I want to download an entire artist's discography from Qobuz using streamrip. Show me the rip command and explain what quality levels 0 through 4 mean so I can choose the right one for my subscription
Prompt 2
How do I configure streamrip to download my Spotify playlist at CD quality by routing it through Deezer, including setting a custom output folder and FLAC as the file format?
Prompt 3
I want to set up a streamrip config file that organizes downloads into a Plex-friendly folder structure. Show me which config keys to change and what values to use
Prompt 4
How do I use streamrip's interactive search mode to find and preview albums before downloading, and how do I check my download database to see what I have already saved?

Frequently asked questions

What is streamrip?

A command-line tool for downloading music from Qobuz, Tidal, Deezer, and SoundCloud, supporting everything from compressed audio up to 24-bit high-resolution files and full artist discographies.

What language is streamrip written in?

Mainly Python. The stack also includes Python, ffmpeg.

How hard is streamrip to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is streamrip for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.