Skip to content

Add Fresh Releases playlist from ListenBrainz - #211

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

Add Fresh Releases playlist from ListenBrainz#211
kgrubb wants to merge 3 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 second

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.

kgrubb and others added 3 commits July 25, 2026 11:26
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.

const (
freshArtistCount = 100
mbMinInterval = 1100 * time.Millisecond

@LumePart LumePart Aug 10, 2026

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would change interval to 1.5 seconds minimum. During testing, I still got 503 responses from MusicBrainz. Metadata fetching had a similar issue when it was being implemented.

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