Home

Spotify Downloader is a Docker image that tracks artists and playlists on Spotify and automatically downloads new music to your library using spotDL and yt-dlp. Tracks are sourced from YouTube and tagged with Spotify metadata, so everything lands neatly organized and ready to play.

Recent Spotify Developer policy changes

Spotify has recently changed its Spotify for Developers policy and the API now requires the app owner to have an active Spotify Premium subscription.

This affects how this project works and may cause it to stop functioning if the app owner does not have Premium.

See the full discussion in #51.

Why you will like it

• 🚀 Set it and forget it: run on a schedule and keep your library updated.
• 🧠 Smart tracking: skip rarely updated artists, or fully sync playlists when you want.
• 🎚️ Flexible formats: use opus, mp3, or any spotDL-compatible format.
• 🗂️ Clean structure: artists and playlists are organized automatically.

How it works

1. Define artists and playlists in tracking.yaml.
2. The container checks what you already have.
3. New content is downloaded and tagged.
4. Your library stays tidy and up to date.

Quick start

If you already have Docker installed, head to Getting Started to launch in minutes.