Is spotify-downloader still maintained?

Yes, active. Last change 8 days ago. Latest release v4.6.0, 17 days ago.

Can I trust spotify-downloader?

Widely used. 27k stars, 10 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to set up spotify-downloader (spotDL/spotify-downloader) · gitmanual

Assembly instructions

spotDL/spotify-downloader

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

Python#download-music#hacktoberfest#mp3#music

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 8 days ago. Latest release v4.6.0, 17 days ago.
Can I trust it?: Widely used27k stars, 10 years old, by an organization. As with any download, get it from the official repo.

Difficulty: Easy
Time: about 5 min
Stars: ★ 26,783
Activity: Updated this month

Saved setup from 4 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗spotdl.readthedocs.ioThe project's own site.

Also: Docs ↗

Download for macOS

v4.6.0 · 10/26/2026 ↗

spotdl-4.6.0-darwin

binary · 44.1 MB · 593 downloads · best match

Download

Raw binary — move it onto your PATH.

curl -LO "https://github.com/spotDL/spotify-downloader/releases/download/v4.6.0/spotdl-4.6.0-darwin"
chmod +x "spotdl-4.6.0-darwin"

Install with a package manager

install script

curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 11 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Python >=3.11,<3.16runtime
1×uv package manager

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/spotDL/spotify-downloader/badge.svg)](https://gitmanual.com/spotDL/spotify-downloader)

Good to know

Dockerfile available (base image: python:3.14-slim-bookworm).
Nested projects: scripts/docs/requirements.txt

Details

License: MIT
Open issues: 94
Branch: master

Files we read (11)

.github/workflows/build-docs.yml

.github/workflows/docker-hub-image-publish.yml

.github/workflows/python-publish.yml

.github/workflows/release-build-check.yml

.github/workflows/standard-checks.yml

.github/workflows/tests.yml

Dockerfile

README.md

docker-compose.yml

docs/installation.md

pyproject.toml

194 files in the repo