Explo bridges the gap between music discovery and self-hosted music systems. It serves as a self-hosted alternative to Spotify’s Discover Weekly, automating music discovery based on your listening history.
Explo uses the ListenBrainz recommendation engine to retrieve personalized tracks and downloads them directly into your music library.
- Fetches weekly music recommendations based on your listening history
- Downloads tracks using YouTube, Soulseek (or both!)
- Adds metadata (title, artist, album) to each file (youtube downloads)
- Creates a “Discover Weekly” playlist in your music system
- Keeps previous playlists for later listening
See the Wiki Home for an overview of supported systems and next steps.
Or jump directly to:
- Getting Started – Installation and setup guide
- Configuration Parameters – Environment variable reference
- System Notes – Known issues and system-specific tips
- FAQ – Common questions
Explo uses the following 3rd-party libraries:
-
ffmpeg-go: A Go wrapper for FFmpeg
-
goutubedl: A Go wrapper for yt-dlp
-
godotenv: A library for loading configuration from .env files
Contributions are always welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.
