Korbs/Explo
1
Fork 0
mirror of https://github.com/LumePart/Explo.git synced 2026-06-23 19:39:25 +00:00
Code Issues Releases Activity
Spotify's "Discover Weekly" for self-hosted music systems
813 commits 4 branches 40 tags 115 MiB
  • Go 62%
  • JavaScript 36.4%
  • Shell 0.6%
  • CSS 0.5%
  • Dockerfile 0.3%
  • Other 0.2%
Find a file
Exact
Markus Kuuse c59caf14d7
 Merge pull request #192 from dammitjeff/echo-logs-to-docker 
echo run logs to stdout to be visible in docker logs
2026-06-22 17:48:04 +03:00
.github/workflows add workaround for binary build 2026-05-12 16:25:28 +03:00
docker clear cronjobs before initializing 2026-06-14 12:59:05 +03:00
licences added Apache License 2.0 2024-12-02 19:38:33 +02:00
src Merge pull request #192 from dammitjeff/echo-logs-to-docker 2026-06-22 17:48:04 +03: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 feat: added path templating and slskd 2026-05-29 10:34:51 -05:00
docker-compose.yaml enable webui in docker 2026-05-09 19:35:33 +03:00
Dockerfile feat: added path templating and slskd 2026-05-29 10:34:51 -05:00
go.mod tidy 2026-06-13 00:47:17 +03:00
go.sum feat: added path templating and slskd 2026-05-29 10:34:51 -05: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 edit readme 2026-06-13 00:46:52 +03:00
sample.env add more variables 2026-06-13 00:28:26 +03: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
  • Import custom playlists from:
    • Apple Music
    • ListenBrainz
    • Spotify
  • Request tracks from YouTube, Soulseek, or both
  • Add metadata to downloaded tracks
  • 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 (be sure to read the development section of our wiki).

For discussion regarding development or help, join our Discord!