# Miserlou/SoundScrape

SoundCloud (and Bandcamp and Mixcloud) downloader in Python.

Repository: https://github.com/Miserlou/SoundScrape
Canonical: https://ross.abutalabs.com/products/soundscrape
Language: Python
License: MIT
License Family: permissive
Last push: 2024-06-23T16:29:11+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4630, "days_push": 801, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1446, forks 143 (observed 2026-08-28T04:04:45.279879+00:00)

## What it is
SoundScrape is a Python command-line tool that downloads tracks, sets, groups, and likes from SoundCloud, as well as albums from Bandcamp and Mixcloud, even when download links are not provided. It saves files as MP3s with automatic ID3 tagging including album art.

## Use cases
- download all tracks from a soundcloud artist
- rip a bandcamp album as mp3s
- download a soundcloud set by url
- grab a user's liked tracks
- download music with id3 tags and album art automatically
- download only high-quality 320kbps tracks
- organize downloaded songs into artist/album folders

## When to choose
- you want a simple pip-installable CLI to archive music from SoundCloud, Bandcamp, or Mixcloud
- you need automatic ID3 tagging and album art on downloaded MP3s
- you want to batch-download an artist's catalog or likes

## When to avoid
- you need a GUI download manager
- you need downloads from platforms like YouTube or Spotify
- you need a maintained library API rather than a CLI, given the project's sparse recent activity

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: web-scraping, cli, audio-processing
- domain: media, developer-tools
- platform: python, cli, cross-platform
- tags: soundcloud, bandcamp, mixcloud, music-downloader, mp3, id3-tags, command-line

## Member repositories
- Miserlou/SoundScrape (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:45.279879+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:36:09.340752+00:00, confidence not recorded.
  - readme: https://github.com/Miserlou/SoundScrape (fetched 2026-08-28T04:04:45.279879+00:00, sha b14ad72d252e)
  - registry_pypi: https://pypi.org/pypi/soundscrape/json (fetched 2026-08-29T11:45:55.445138+00:00, sha 35c583cb0a0d)
- Data as of 2026-08-30T08:39:29.467469+00:00.