Repository files navigation

Explo bridges the gap between music discovery and self-hosted music systems. Its main function is to act as a self-hosted alternative to Spotify’sDiscover Weekly, automating music discovery based on your listening history.

Explo uses theListenBrainz recommendation engine to retrieve personalized tracks and downloads them directly into your music library.

• Fetch personalized playlists from ListenBrainz (controlled by flags):
  • Weekly Exploration
  • Weekly Jams
  • Daily Jams
• Download tracks from YouTube, Soulseek, or both
• Add metadata (title, artist, album) to YouTube downloads
• Create playlists in your music system
• Keep previous playlists for later listening

See theWiki Home for an overview of supported systems and next steps.

Or jump directly to:

• Getting Started – Installation and setup guide
• Configuration Parameters – Environment variable and flag reference
• System Notes – Known issues and system-specific tips
• FAQ – Common questions

Explo uses the following 3rd-party libraries:

• ffmpeg-go: Go wrapper for FFmpeg

• goutubedl: Go wrapper for yt-dlp

• godotenv: Load configuration from.env files

• ytmusicapi: Unofficial Youtube Music API

• notify: Module for sending notifications to different services

Contributions are always welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.