What Streamrip actually downloads for you

Streamrip is a command-line tool that pulls music from streaming services and saves it to your computer as audio files. When you run it, you get to choose what format those files are in — MP3, FLAC, AAC, or others — and where they land on your hard drive. The tool itself does not decide the file type; you do, before you start the download.

The files you end up with depend entirely on what you tell Streamrip to grab and what settings you configure. Most people use it to download entire albums or playlists, but you can target single tracks if you want. The audio quality, file size, and whether you get cover art all come down to the choices you make before hitting the download button.

Key Takeaways

  • Streamrip saves music as audio files in formats you choose — MP3 works on almost everything, while FLAC gives you lossless quality at the cost of larger file sizes.
  • You need to configure Streamrip's settings file before your first download to tell it what format you want, where to save files, and whether to grab cover art.
  • The tool downloads metadata (artist name, album title, track number) along with the audio, so your music library stays organized automatically.
  • Most people organize downloads by artist and album folder, which Streamrip can do automatically if you set it up that way in the configuration.

Choosing between MP3, FLAC, and other audio formats

MP3 is the safest choice if you are not sure what to pick. It plays on phones, car stereos, older computers, and basically every device made in the last twenty years. File sizes are small — a typical three-minute song is around 3 to 5 megabytes — so you can fit thousands of songs on a phone or laptop. The trade-off is that MP3 compresses the audio, which means some of the original sound information is thrown away.

FLAC (Free Lossless Audio Codec) keeps all the original audio information, so it sounds identical to what the streaming service sends. The downside is file size: the same three-minute song becomes 25 to 35 megabytes. FLAC works on computers, some phones with the right app, and dedicated music players, but not on older devices or car stereos. Pick FLAC only if you have the storage space and devices that support it.

AAC and Opus are middle-ground options. AAC is Apple's format and works on iPhones and iTunes. Opus is newer and gives you better sound quality than MP3 at similar file sizes, but fewer devices support it. Unless you have a specific reason to use one of these, MP3 or FLAC are your main choices.

Setting up Streamrip's configuration file

Before Streamrip downloads anything, you need to edit its configuration file — a text document that tells the tool what to do. On Windows, this file lives in C:\Users\[YourUsername]\AppData\Roaming\streamrip\config.toml. On Mac, it is in ~/.config/streamrip/config.toml. On Linux, it is also in ~/.config/streamrip/config.toml.

Open the config file with any text editor (Notepad on Windows, TextEdit on Mac). Look for the section that says [downloads] and find the line that says format. Change it to the format you want — format = "mp3" for MP3, or format = "flac" for FLAC. Also find the line that says folder and change it to where you want your music saved, like folder = "C:\Music" on Windows or folder = "~/Music" on Mac.

While you are in the config file, look for embed_cover_art and set it to true if you want album artwork saved with each file. This makes your music library look better in media players. Save the file and close it — Streamrip will read these settings the next time you run it.

Understanding metadata and folder organization

Metadata is the information attached to each audio file — the artist name, album title, track number, and release year. Streamrip downloads this automatically from the streaming service and embeds it into each file. This means when you open your music in a player like iTunes, Foobar2000, or VLC, the songs are already labeled correctly and sorted by artist and album.

You can tell Streamrip to organize your downloaded files into folders automatically. In the config file, look for the folder_format line. The default is usually something like {artist}/{album}/{track_number} - {title}, which creates a folder for each artist, a subfolder for each album, and names each file with its track number and song title. This keeps everything tidy without you having to sort files manually.

If you want a different organization — say, all albums in one folder sorted by year — you can change the folder format. The config file usually has examples of other patterns you can use. Just remember that whatever pattern you choose applies to all future downloads.

File sizes and storage space to expect

How much space your downloads take depends on the format and how much music you grab. A typical album with 12 songs takes up roughly 40 to 60 megabytes in MP3 format, or 300 to 400 megabytes in FLAC. If you are downloading a large playlist or discography, the numbers add up fast.

Before you start downloading, think about where the files will live. If you are saving to your laptop, make sure you have at least 10 to 20 gigabytes free — that gives you room for a few hundred albums without running out of space. If you are saving to an external hard drive, you have more flexibility, but external drives can fail, so consider keeping backups of music you really care about.

Streamrip will not warn you if your drive is running out of space, so check your available storage before you start a large download. If the download stops partway through, you can usually resume it by running the same command again — Streamrip skips files it has already downloaded.

What happens if a download fails or gets interrupted

If your internet cuts out or Streamrip crashes in the middle of a download, the files it already saved stay on your computer. When you run Streamrip again with the same command, it checks what is already there and only downloads the missing tracks. This means you do not have to start over from the beginning.

Sometimes a single track fails to download while the rest of the album succeeds. Streamrip will usually tell you which track had the problem. You can try downloading just that track again by itself, or you can skip it and move on. If the same track fails multiple times, it might be a problem with the streaming service or your connection rather than Streamrip itself.

If you want to delete a download and start fresh, just delete the folder from your computer and run Streamrip again. It will treat it as a new download and grab everything from scratch.

Frequently Asked Questions

Can I download the same album in both MP3 and FLAC?

Yes, but you need to change the format setting in the config file, run the download, then change it back and run it again. Streamrip will not overwrite files that already exist, so the first version stays on your computer while the second version goes into a different location or gets skipped. Most people stick with one format to avoid confusion.

What if I want to organize my files differently than Streamrip's default?

Edit the folder_format line in the config file before you download. You can use different patterns like {artist}/{year} - {album} or {album}/{track_number} - {title}. Check the Streamrip documentation or config file comments for all available options. Changes only apply to new downloads, not files you have already saved.

Do I need to download cover art separately?

No. If you set embed_cover_art = true in the config file, Streamrip grabs the album artwork from the streaming service and saves it inside each audio file. Most media players display this artwork automatically when you play the song.

Can Streamrip download music videos or just audio?

Streamrip downloads audio files only. It does not handle video. If you need music videos, you would need a different tool designed for that purpose.

What if a track is not available on the streaming service?

Streamrip will skip it and move on to the next track. It will usually tell you which tracks were skipped. Some albums have regional restrictions or licensing issues that prevent certain songs from being downloaded in your location.