Skip to content

Commit da5f8c7

Browse files
committed
Edit for v0.11.0
1 parent f164a0e commit da5f8c7

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

README.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
# Explo - Discover Weekly for Self-Hosted Music Systems
1+
# Explo - Music Discovery for Self-Hosted Music Systems
22

3-
**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.
3+
**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.
44

55
Explo uses the [ListenBrainz](https://listenbrainz.org/) recommendation engine to retrieve personalized tracks and downloads them directly into your music library.
66

77
---
88

99
## Features
1010

11-
- Fetches weekly music recommendations based on your listening history
12-
- Downloads tracks using YouTube, Soulseek (or both!)
13-
- Adds metadata (title, artist, album) to each file (youtube downloads)
14-
- Creates a “Discover Weekly” playlist in your music system
15-
- Keeps previous playlists for later listening
16-
11+
- Fetch personalized playlists from ListenBrainz (controlled by flags):
12+
- Weekly Exploration
13+
- Weekly Jams
14+
- Daily Jams
15+
- Download tracks from YouTube, Soulseek, or both
16+
- Add metadata (title, artist, album) to YouTube downloads
17+
- Create playlists in your music system
18+
- Keep previous playlists for later listening
1719
---
1820

1921
## Documentation
@@ -23,19 +25,21 @@ See the [Wiki Home](https://github.com/LumePart/Explo/wiki) for an overview of s
2325
Or jump directly to:
2426

2527
- [Getting Started](https://github.com/LumePart/Explo/wiki/2.-Getting-Started) – Installation and setup guide
26-
- [Configuration Parameters](https://github.com/LumePart/Explo/wiki/3.-Configuration-Parameters) – Environment variable reference
28+
- [Configuration Parameters](https://github.com/LumePart/Explo/wiki/3.-Configuration-Parameters) – Environment variable and flag reference
2729
- [System Notes](https://github.com/LumePart/Explo/wiki/4.-System-Notes) – Known issues and system-specific tips
2830
- [FAQ](https://github.com/LumePart/Explo/wiki/6.-FAQ) – Common questions
2931

3032
## Acknowledgements
3133

3234
Explo uses the following 3rd-party libraries:
3335

34-
- [ffmpeg-go](https://github.com/u2takey/ffmpeg-go): A Go wrapper for FFmpeg
36+
- [ffmpeg-go](https://github.com/u2takey/ffmpeg-go): Go wrapper for FFmpeg
37+
38+
- [goutubedl](https://github.com/wader/goutubedl): Go wrapper for yt-dlp
3539

36-
- [goutubedl](https://github.com/wader/goutubedl): A Go wrapper for yt-dlp
40+
- [godotenv](https://github.com/joho/godotenv): Load configuration from `.env` files
3741

38-
- [godotenv](https://github.com/joho/godotenv): A library for loading configuration from .env files
42+
- [ytmusicapi](https://github.com/sigma67/ytmusicapi): Unofficial Youtube Music API
3943

4044
## Contributing
4145

0 commit comments

Comments
 (0)