passive-music-dl documentation

A background service that monitors Spotify and YouTube Music playlists and automatically downloads newly added tracks with metadata and album artwork.

Product documentation

• Overview - what the tool is and how it works
• Architecture - module map, sync flow, async model
• Configuration - the canonical config reference
• Data model - SQLite schema, tags, supported formats

Guides

• MusicBrainz metadata migration - using scripts/musicbrainz_migrate.py

Architecture decisions

• Architecture decision records - the reasoning behind the project's design decisions