Explo

Open source

Spotify's "Discover Weekly" for self-hosted music systems

1.8K stars0 likes0 views

About

Spotify's "Discover Weekly" for self-hosted music systems

Explo - Music Discovery for Self-Hosted Music Systems

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’s Discover Weekly, automating music discovery based on your listening history.

Explo uses the ListenBrainz recommendation engine to retrieve personalized tracks and automatically imports them into your music library.

Features

Automatic music discovery powered by ListenBrainz
Web UI for setup, scheduling, and playlist import management
Fetch personalized playlists from ListenBrainz:
- Weekly Exploration
- Weekly Jams
- Daily Jams
Import custom playlists from:
- Apple Music
- ListenBrainz
- Spotify
Automatically request playlist tracks from YouTube and Soulseek, or albums through Lidarr
Add metadata to downloaded tracks
Create playlists in your music system
Optionally keep previous playlists for later listening

Documentation

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

Or jump directly to:

Quick Start – Get Explo running with docker
Getting Started – Installation and setup guide
Configuration Parameters – Environment variable and flag reference
System Notes – Known issues and system-specific tips
FAQ – Common questions

Kubernetes

bash

helm repo add explo https://lumepart.github.io/Explo && helm repo update
helm install explo explo/explo --namespace explo --create-namespace

See charts/explo/README.md.

Acknowledgements

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
gocron: Internal cron scheduling

Contributing

Contributions are welcome! For suggestions, bug reports, or feature requests, please open an issue. Before opening a pull request, please read the contributing guide

For discussion regarding development or help, join our Discord!