Korbs/Explo
1
Fork 0
mirror of https://github.com/LumePart/Explo.git synced 2026-05-14 03:20:14 +00:00
Code Issues Releases Activity
Spotify's "Discover Weekly" for self-hosted music systems
664 commits 3 branches 37 tags 30 MiB
  • Go 64.5%
  • JavaScript 33.3%
  • Shell 0.9%
  • Dockerfile 0.5%
  • CSS 0.4%
  • Other 0.4%
Find a file
Exact
Markus Kuuse fc429acda7
 Merge pull request #140 from dammitjeff/env-hotfix 
Add Hotfix for .env first time startup issues
2026-05-12 23:07:21 +03:00
.github/workflows add workaround for binary build 2026-05-12 16:25:28 +03:00
docker Change variable naming for more clarity 2026-05-11 20:36:44 +03:00
licences added Apache License 2.0 2024-12-02 19:38:33 +02:00
src fix check error on file close 2026-05-12 12:43:41 -07:00
visual add img directory 2026-05-12 15:53:33 +03:00
.dockerignore Migrate WebUI to React/Vite 2026-04-24 22:48:52 -07:00
.gitignore Add new playlistcard, new fetch tracklist and download check, simplified playlist logic, caching mechanism for album artwork, new UI refresh 2026-04-26 11:11:38 -07:00
docker-compose.yaml enable webui in docker 2026-05-09 19:35:33 +03:00
Dockerfile feat(cli): add --version flag with build-time injection 2026-05-04 04:12:06 +02:00
go.mod Add base for internal cron management 2026-05-11 20:43:48 +03:00
go.sum Add base for internal cron management 2026-05-11 20:43:48 +03:00
LICENSE Create LICENSE 2023-11-10 12:50:42 +02:00
NOTICE reference to ytmusicapi 2025-10-26 15:22:18 +02:00
README.md add only dashbboard visual 2026-05-12 15:58:40 +03:00
sample.env Add WIZARD_COMPLETE configuration to sample.env 2026-04-27 17:12:22 -07:00

README.md

Explo - Music Discovery for Self-Hosted Music Systems

Discord

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
  • Request 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

Documentation

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

Or jump directly to:

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 always welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.

For discussion regarding development or help, join our Discord!