Skip to content

Add Fresh Releases playlist from ListenBrainz - #211

Merged
LumePart merged 6 commits into
LumePart:devfrom
kgrubb:poc/fresh-releases
Oct 31, 2026
Merged

LumePart merged 6 commits into
LumePart:devfrom
kgrubb:poc/fresh-releases

Conversation

@kgrubb

@kgrubb kgrubb commented Jul 25, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds a fresh-releases scheduled playlist. Explo pulls recent albums from artists in the user's ListenBrainz history, expands each release through MusicBrainz, and imports the full tracklists through the existing download and playlist flow.

Screenshot

Fresh Releases settings

Added

  • fresh-releases playlist type (--playlist fresh-releases)
  • Personalized ListenBrainz Fresh Releases discovery
  • Fallback matching sitewide fresh releases against the user's top artists
  • Schedule and UI support in Home, Settings, Wizard, and manual runs
  • README and sample environment documentation

Behavior

  • Looks back 30 days by default
  • Selects up to 8 releases by default
  • Includes the full tracklist from each selected release
  • Prefers albums, then EPs, then singles
  • Runs weekly by default (Wednesday 08:30)
  • Paces MusicBrainz requests at about one request per 1.5 seconds

Configuration

FRESH_RELEASES_SCHEDULE=30 8 * * 3
FRESH_RELEASES_FLAGS=--playlist fresh-releases
FRESH_RELEASES_DAYS=30
FRESH_RELEASES_MAX_RELEASES=8

Set FRESH_RELEASES_MAX_RELEASES=0 to include every matching release in the configured window. Existing schedules are unchanged.

Comment thread src/discovery/fresh_releases.go Resolved
kgrubb and others added 4 commits October 12, 2026 21:13
Pulls recent albums from artists you already listen to, expands them
through MusicBrainz, and wires into the usual Explo schedule/UI path.
Keep full album tracklists while allowing the lookup window and release count
to be tuned through the existing environment configuration. Document the new
playlist and settings in the README and sample env files.
Album releases do not change often enough to justify a daily full-album
import. Default to Wednesday 08:30 so it sits between Weekly Jams and
Weekly Exploration.
1.1s still triggered 503s in review testing, matching earlier
metadata enrichment experience.
@kgrubb
kgrubb force-pushed the poc/fresh-releases branch from f4973ba to b4286a7 Compare October 13, 2026 01:14
kgrubb and others added 2 commits October 12, 2026 21:26
Use personalized ListenBrainz only, default prefetch like on-repeat, and skip metadata enrich after MusicBrainz expansion.
@LumePart
LumePart merged commit f702e33 into LumePart:dev Oct 31, 2026
4 checks passed
@LumePart

Copy link
Copy Markdown
Owner

Thanks for the PR! Also sorry for letting it sit open for so long, made a minor adjustment and merged it

@kgrubb

kgrubb commented Oct 31, 2026

Copy link
Copy Markdown
Contributor Author

All good, thanks so much for the review and maintenance!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants