Spotizerr

Spotizerr is a self-hosted music download manager that lets users search Spotify content and download tracks, albums or playlists. It can use Deezer as a fallback to obtain higher-quality (FLAC) sources and exposes a backend API and web UI for monitoring and management.

Key Features

• Search Spotify and queue individual tracks, albums and playlists for download.
• Deezer fallback: attempts to download lossless/FLAC when available as a higher-quality source.
• Async/background downloads using Celery with progress tracked and streamed to clients via Server-Sent Events (SSE).
• JWT-based authentication with optional SSO providers and a user/role system for multi-user setups.
• Configuration for concurrent-download limits, retry logic, format conversion and naming templates; supports real-time mode to align download time with track length.

Use Cases

• Automate population of a self-hosted music library by allowing users to request and enqueue content.
• Archive playlists or artist catalogs locally with optional conversion to preferred formats.
• Use as part of a media server pipeline to fetch metadata and files for long-term storage.

Limitations and Considerations

• Legal and takedown risk: components that interact with third-party streaming services have historically attracted takedown actions and the original GitHub presence experienced removals; users should be aware of potential legal and stability implications.
• Operational constraints: relies on third-party account credentials, may hit Spotify API rate limits or encounter token/key fetching issues; requires correct setup of the auth helper for Spotify credentials.

Spotizerr provides a practical API-driven downloader with a focus on large-scale library automation and lossless fallbacks. It is intended for technically competent operators who understand the operational and legal considerations of fetching content from third-party streaming services. (spotizerr.readthedocs.io)