Skip to content

Add Fresh Releases playlist from ListenBrainz - #211

Open
kgrubb wants to merge 5 commits into
LumePart:devfrom
kgrubb:poc/fresh-releases
Open

kgrubb wants to merge 5 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 Outdated
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
Use personalized ListenBrainz only, default prefetch like on-repeat, and skip metadata enrich after MusicBrainz expansion.

This branch has not been deployed

No deployments
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