JorenandClaude Opus 5
b5d4d5688d
internal/download The ~40-line progress-bar decorator stack was copy-pasted into three download paths and had started to drift; it is now newDownloadBar, which returns a nil bar when progress is off (so callers use it unconditionally) plus a finish func to defer. The three hand-rolled read/write loops that differed only in whether they touched a bar become copyWithProgress. FileDeezerEncrypted and FileYandexEncrypted were ~90% identical: mkdir, GET, status check, create output, bar, cleanup-on-failure, Content-Length check, fsync. That scaffolding is now streamEncrypted, and each function supplies only its decryption step. Also switches the io.EOF/io.ErrUnexpectedEOF comparisons to errors.Is. internal/app Three copies of "coerce a JSON array that may be []any or []map[string]any" become anySlice, which also reports whether the value was an array at all so callers can still distinguish missing from empty. The worker-pool dispatch existed three times and the copies disagreed: two counted failures under a mutex and logged inline with the track id, while the third collected errors in a channel and logged them all after wg.Wait() without the id. runTrackWorkers unifies them on the inline form, which reports failures as they happen and names the track, and keeps the mutex held across the log so failure lines cannot interleave. Tests The progress-bar paths had no coverage at all, because progress is disabled when not attached to a terminal; four new tests force it on via the existing STREAMRIP_GO_FORCE_PROGRESS escape hatch and cover the determinate bar, the unknown-length spinner, Deezer decryption with a bar attached, and the failure path still removing the partial file. internal/download coverage 53% -> 63%. Three cancellation tests pin the Ctrl-C fix. Verified as genuine regression tests by reverting the guards: without them the rip walks all 40 tracks of a cancelled album, logs a failure for each, and Rip() returns nil. Adds store.SQLite.IsFailed, the read complement to MarkFailed, used by the bookkeeping test to confirm failure records still land under a cancelled context. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
streamrip-go
A Go port of streamrip: a command-line music downloader for Qobuz, Tidal, Deezer, SoundCloud, Yandex Music and Beatport. Downloads tracks, albums, playlists, artist discographies and labels, tags them, optionally embeds cover art and converts the result.
You need your own paid account for any source you use. This tool does not provide or circumvent access to anything.
Requirements
- Go 1.25 or newer (to build)
ffmpegandffprobe— tagging and format conversionyt-dlp— required for SoundCloud only
# Arch
sudo pacman -S ffmpeg yt-dlp
# Debian/Ubuntu
sudo apt install ffmpeg && pipx install yt-dlp
# macOS
brew install ffmpeg yt-dlp
Build
make build # -> ./rip, with version info stamped in
make install # into $(go env GOBIN)
./rip --version
Or without make: go build ./cmd/rip.
Configuration
The first run writes a config file and tells you where. It lives at
$XDG_CONFIG_HOME/streamrip/config.toml (~/Library/Application Support/streamrip/config.toml on macOS).
rip config path # print the path
rip config open # open in $EDITOR
rip config reset # restore defaults
config.toml.example documents every key. The file holds credentials in
plaintext — provider passwords, the Deezer ARL cookie and OAuth tokens — so it
is created 0600. Keep it that way.
Credentials you need to set, per source:
| Source | Required config |
|---|---|
| Qobuz | email_or_userid + password_or_token (md5 of your password), or use_auth_token = true with an auth token |
| Tidal | access_token / refresh_token |
| Deezer | arl (recommended), or email + password |
| Yandex | access_token |
| Beatport | username + password |
| SoundCloud | none; handled via yt-dlp |
Each provider section also has vendor app_client_id-style keys. Leave them
empty: they default to values built into the binary. They exist so that if a
provider rotates one, you can patch your install with a config edit instead of
waiting for a release.
Usage
rip url https://play.qobuz.com/album/abc123
rip url https://www.beatport.com/release/example/123 --force
rip id qobuz album abc123
rip search qobuz album "kind of blue"
rip search tidal track "teardrop" --first
rip file urls.txt # one URL per line, or a JSON list of IDs
rip lastfm --source qobuz <lastfm-playlist-url>
rip database downloads # what has already been downloaded
rip database failed
Global options (these must come before the command):
-f, --folder <path> Override downloads folder
-q, --quality <0-4> Override provider quality
-c, --codec <codec> Convert after download: ALAC, FLAC, OGG, MP3, AAC
-ndb, --no-db Ignore the download database
--no-progress Disable progress bars
--no-ssl-verify Disable TLS verification
--config-path <path> Use a custom config file
-v, -vv Verbose logging (-vv also logs HTTP requests)
-V, --version Show version
-h, --help Show help
Run rip help <command> for per-command help.
Quality
-q is a 0–4 scale mapped onto each provider's own ladder. Qobuz and Beatport
have no tier 0, so -q 0 is raised to 1 for those and reported on stderr.
| Source | Range | 0 | Top tier |
|---|---|---|---|
| Qobuz | 1–4 | — | FLAC 24-bit up to 192 kHz |
| Tidal | 0–4 | LOW (HE-AAC) | HI_RES_LOSSLESS |
| Deezer | 0–4 | MP3 128 | FLAC (anything ≥ 2) |
| Yandex | 0–4 | LOW | lossless |
| Beatport | 1–4 | — | FLAC 16/44.1 |
| SoundCloud | 0–4 | ignored | provider-defined |
Each provider saturates at the top of its own ladder, so values above its highest real tier are accepted and behave as that tier.
Download database
Completed downloads are recorded in a SQLite database and skipped next time.
--force / --ignore-db overrides this for one run; -ndb disables it
entirely. Paths are configurable under [database].
If you are upgrading from a build that predates source tracking, the database
is migrated on first open and a copy is kept alongside it as
downloads.db.bak-<timestamp>.
Development
make check # gofmt + vet + tests, what CI runs
make test
make race
make cover
make lint # needs golangci-lint
The test suite runs in about a second and makes no network requests; provider
tests drive httptest servers.
Layout:
cmd/rip CLI entry point, one file per command group
internal/app orchestration: queue, resolve, rip
internal/provider/* one client per source, behind provider.Client
internal/download HTTP downloads, progress bars, Deezer/Yandex decryption
internal/audio/{tag,convert} ffmpeg tagging and conversion
internal/{naming,artwork,store,config,netutil,ratelimit,jsonutil,verbose}
Known rough edges
Two deliberate pieces of technical debt, both documented rather than hidden:
- No shared HTTP layer. The request/decode/retry sequence is reimplemented
in each provider client, and retry on 429/5xx exists in only two of six. A
provider/transportpackage would remove roughly 700 lines. - Metadata is
map[string]any.provider.Clientreturns untyped maps, so each client hand-builds an undeclared "Qobuz-shaped" schema thatcmd/rip/search.gothen unpicks in a long switch. A typed media model is the natural next step;internal/provider/qobuz/model.gois a started-and-parked attempt at it.
License
No license file is present, so this is "all rights reserved" by default. Add one before distributing. Note that upstream streamrip is GPL-3.0.