v0.11.3

v0.11.3 CHANGELOG

Enhancements

• #76 Added option to start Explo on container start
  • To execute Explo on container start, set EXECUTE_ON_START to true in docker-compose.yaml
• #78 Allow to optionally pass cookies for yt-dlp
  • In docker it's set through volume mapping
  • In binary it can be set in .env via COOKIES_PATH variable

Fixes

• #79 Set concurrent track searches to 1 (previously 5)
  • Slskd v0.24.0 introduced rate-limiting which disabled concurrent searching
  • Due to this change, Explo will take longer to fetch all tracks.
• Fixed PERSIST defaulting to false when it was set to true in .env and --persist wasn’t passed. (now it's truly fixed)

Misc

• Set timeout for slskd search request to 15s (previously 20s)
• Edited docker-compose.yaml, sample.env and wiki to document all changes above

---

Full Changelog: v0.11.2...v0.11.3

v0.11.2

v0.11.2 CHANGELOG

Fixes

• #73 Reverted the Docker change that ran cron jobs under a non-root account.
• Explo no longer removes Slskd folders when they still contain files (this was fixed in v0.11.1)
  • Previously, in rare cases where Slskd downloaded multiple tracks to the same folder, Explo would move only the first file and delete the others.
• Fixed PERSIST defaulting to false when it was set to true in .env and --persist wasn’t passed.

---

Full Changelog: v0.11.1...v0.11.2

v0.11.1

v0.11.1 CHANGELOG

Enhancements

• #53 Add PUID/GID support to the Docker container (by @lpukatch)
• [subsonic] #61 Added a PUBLIC_PLAYLIST variable to optionally make Subsonic playlists public
• [slskd] #65 Added support for renaming tracks during migration when RENAME_TRACK is set to true
• #67 Extended FILTER_LIST support to slskd and added default filters: clean,acapella
• #70 Deprecated the PERSIST environment variable and replaced it with the --persist flag, allowing playlists to persist individually

Fixes

• #56 Added a USE_SUBDIRECTORY variable to control whether to download/move tracks under a subdirectory (for systems using structured folders, e.g. Jellyfin)
• #63 Added a CLIENT_HTTP_TIMEOUT variable to configure custom HTTP timeouts for music systems

Internal

• Switched to the slog package for logging. The DEBUG variable has been deprecated and replaced with LOG_LEVEL.

Misc

• Updated sample.env and Wiki to reflect the changes above.

---

New Contributors

• @lpukatch made their first contribution in #53

Full Changelog: v0.11.0...v0.11.1

v0.11.0

v0.11.0 CHANGELOG

Features

• #47 YouTube Music as Downloader (by @Grygon)
  • YouTube Music is used to find tracks if YOUTUBE_API_KEY is not set in .env.
  • Requires Python ≥3.10 and ytmusicapi if using the binary without an API key.
• Flag Support
  • Flags allow adding custom parameters to each Explo cron job.
  • In Docker, flags can be defined in docker-compose.yaml.
• #12 Support for Daily-Jams and Weekly-Jams (via flags)
  • Playlists are now named according to ListenBrainz (e.g. Weekly-Exploration instead of Discover-Weekly).
    NOTE: To enable "Daily-Jams", troi-bot must be followed in ListenBrainz.
• Multiple Download Modes (via flags)
  • skip – skip downloading altogether.
  • force – download tracks whether or not they exist in the local library.

Don't forget to check out the flag variable reference in the docs

Enhancements

• #42 Flag option to exclude local tracks from playlists
• #46 Files are now downloaded/moved into a subfolder in your download directory (subfolder name matches the playlist name)

Fixes

• #48 Truncate file names if they are too long

Misc

• Updated README, Wiki, and docker-compose.yaml to reflect the changes above.

---

New Contributors

• @Grygon made their first contribution in #47

Full Changelog: v0.10.3...v0.11.0

v0.10.3

v0.10.3 CHANGELOG

[ENHANCEMENT] #43 Add ARM support by @frostplexx
[ENHANCEMENT] #44 Add ListenBrainz username to playlist description

[INTERNAL] Refactor to monitoring functions (Thanks for the base @avedor (#40))

[FIX] #17 Plex API token didn't get passed correctly

New Contributors

• @frostplexx made their first contribution in #43

Full Changelog: v0.10.2...v0.10.3

v0.10.2

v0.10.2 CHANGELOG

PS! When using MPD with slskd, download migration is now required (Explo doesn't search tracks from SLSKD_DIR anymore)

[FEATURE] Migrate slskd downloads to the main download directory

• Requires MIGRATE_DOWNLOADS=true in .env
• SLSKD_DIR must be set for binary versions of Explo
• In Docker, SLSKD_DIR is set via volume mapping

[IMPROVEMENT] #31 Read Docker environment variables as a fallback (by @avedor)
[IMPROVEMENT] Fully remove all slskd searches/downloads (previously only failed ones were removed)
[IMPROVEMENT] Support for setting container timezone in docker-compose.yml

[FIX] #37 Rename YouTube download extension from .mp3 to .opus

[MISC] Added a few debug log lines for better traceability

Full Changelog: v0.10.1...v0.10.2

v0.10.1

v0.10.1 CHANGELOG

[IMPROVEMENT] Search songs only by their title on all music systems

[FIX] Get correct file path in Plex
[FIX] Don't match by Path, if track doesn't have file variable

[MISC] Added debug logs if downloaded temp file from youtube can't be deleted
[MISC] Increased buffer between soft and hard delete on slskd

Full Changelog: v0.10.0...v0.10.1

v0.10.0

v0.10.0 CHANGELOG

[FEATURE] Added support for Soulseek downloads using slskd

• Requires a running Slskd instance.
• Several new variables were introduced for configuration (see wiki).

[IMPROVEMENT] Large internal refactor

• Modularized codebase to make future music system/download client integrations easier.

[IMPROVEMENT] More accurate song matching for all systems (thanks @avedor for Jellyfin & Emby implementation)

[FIX]

• Fixed #18 – thanks @firewalkwithm3
• Fixed #14 – thanks @avedor

[MISC]

• Environment variables in sample.env are now grouped by functionality
• A full Wiki is now available, including:
  • Quick setup
  • Docker volume schematics
  • Configuration reference
  • System-specific notes

[DEPRECATION]

• Removed legacy SUBSONIC_* variables (deprecated since v0.6.0)

Full Changelog: v0.8.4...v0.10.0

v0.8.4

v0.8.4 CHANGELOG

[MISC] Added Debug message when request returns a NOK response code

Full Changelog: v0.8.3...v0.8.4

v0.8.3

v0.8.3 CHANGELOG

[FIX] Last release didn't quite fix the malformed Plex URL

Full Changelog: v0.8.2...v0.8.3