# spotDL/spotify-downloader

Download your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).

Repository: https://github.com/spotDL/spotify-downloader
Canonical: https://ross.abutalabs.com/products/spotify-downloader
Homepage: https://spotdl.readthedocs.io/en/latest/
Language: Python
License: MIT
License Family: permissive
Topics: mp3, spotify, download-music, music, song-lyrics, song, youtube-music, playlists, spotdl, spotdl-cli, hacktoberfest, python
Last push: 2026-08-12T04:08:03+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 93, longevity 100
- inputs: {"age_days": 3710, "days_push": 21, "days_rel": 44, "gap_med": 16, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 25921, forks 2226 (observed 2026-08-28T04:11:38.749514+00:00)

## What it is
spotDL is a Python command-line tool that finds songs from Spotify playlists on YouTube and downloads them as MP3 files with album art, lyrics, and metadata. It is installable via pip, prebuilt executables, Docker, or package managers like the AUR.

## Use cases
- download spotify playlists as mp3 files
- download songs from spotify with album art and metadata
- convert spotify playlist to local music library
- cli music downloader from youtube
- add lyrics and metadata to downloaded songs
- bulk download spotify tracks

## When to choose
- you want to mirror Spotify playlists to local MP3 files with tags and cover art
- you prefer a fast, scriptable CLI with pip/Docker installation
- you need cross-platform support including Termux and Arch

## When to avoid
- you need lossless or direct-from-Spotify audio streams
- you want a graphical music downloader
- downloading copyrighted music from YouTube is not permitted in your jurisdiction or use case

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, audio-processing, web-scraping, file-system
- domain: media, audio
- platform: python, cli, cross-platform, windows
- tags: spotify, youtube-music, music-downloader, mp3, metadata, album-art, lyrics, playlists, ffmpeg, command-line, automation, docker, linux, macos

## Member repositories
- spotDL/spotify-downloader (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:38.749514+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-29T16:55:57.495352+00:00, confidence not recorded.
  - readme: https://github.com/spotDL/spotify-downloader (fetched 2026-08-28T04:11:38.749514+00:00, sha 5d516f6c5cf7)
  - homepage: https://spotdl.readthedocs.io/en/latest/ (fetched 2026-08-29T07:52:25.852927+00:00, sha e1ccd0a39d13)
- Data as of 2026-08-30T08:39:29.467469+00:00.