Butler Music

A self-hosted Spotify alternative. Download music with yt-dlp, organize it into a personal library, and stream it from a Spotify-style web UI with crossfade, queue, playlists, synced lyrics, and multi-user family accounts.

Features:

Core Playback & Library

• Web player with crossfade, queue management, and persistent playback state
• Album art with fallback to artist images and graceful degradation
• Cross-device playback control — control what's playing from any device
• Artist pages with biography (via MusicBrainz)

Music Discovery & Personalization

• Daily Mix generator — LLM-powered (via OpenRouter) suggestions based on your listening history, auto-resolved and downloaded
• Spotify OAuth integration to import existing playlists
• ListenBrainz scrobbling — sync your listening history

Lyrics & Metadata

• Live synced lyrics on web and Android (YouTube + LyricFind resolution with 2-second tolerance)
• Album art caching with automatic cleanup
• Song metadata auto-enriched from downloads and existing files

Multi-User & Admin

• Multi-user accounts via invite codes (admin can generate and manage)
• JWT-based auth with bcrypt password hashing
• Admin panel for library management, settings, and user control

Music Management

• Download via yt-dlp with retry logic for resilience
• Manual upload folder with auto-indexing (mp3, m4a, flac, opus, ogg, wav, aac)
• Lossless download setting for admin-controlled audio quality
• Automatic folder scanning every few minutes, or manual "Scan Now" trigger

API & Compatibility

• Subsonic API compatibility for third-party client support
• Offline downloads on Android with sync across devices

Mobile (Android)

• Native Kotlin/Compose app with 1:1 feature parity to web
• Offline playback with selective download management
• Android Auto support for in-car control
• Real-time playback sync across devices