Bandcamp Web New Release Digest

WHAT IT DOES

This tool helps you stay on top of new music from artists and labels you follow on Bandcamp. It scans pages for release data—titles, artists, album art, release dates, formats, and prices—and displays a digest panel sorted by date. Releases are automatically marked as "NEW" when first detected, and the panel highlights which releases are already in your collection or wishlist. Quick "Add to Wishlist" and "Follow Artist" buttons let you manage your music library without leaving the page. Desktop notifications alert you when new releases are detected from followed artists, ensuring you never miss a new album or EP. The digest window is user-configurable, and owned releases can be shown or hidden.

WHERE IT RUNS

The script activates on Bandcamp pages (bandcamp.com), including the home page, discover page, collection, wishlist, and artist/label pages. It automatically detects release items using multiple extraction strategies that work across different Bandcamp layouts. The panel appears as a draggable overlay that stays accessible as you browse new music.

HOW TO USE

Navigate to any Bandcamp page containing release listings. The panel will appear showing new releases detected within the digest window (default 30 days). Set the "Days" input to adjust the digest window—releases older than this are excluded. Toggle "Owned on/off" to show or hide releases you already own. Set the "Refresh (s)" input to control how often the script checks for updates (default 60 seconds). Click the star (☆) button to add a release to your wishlist tracking; click it again to remove. Click the plus (+)/check (✓) button to follow/unfollow an artist. Click the "Open" button to search for the release on Bandcamp. The "Scan" button manually refreshes the data, and "Reset Seen" clears all "seen" markers so you can rescan the same releases. Desktop notifications are sent when new releases are detected from followed artists.

THE TECHNICAL MECHANISM

The script employs a multi-strategy DOM extraction approach for Bandcamp's dynamic interface. It first attempts structured selectors targeting known class names like .release-item, .music-grid-item, and .release-card, then falls back to heuristic detection of release containers based on content patterns including release types (album, EP, single) and music-related keywords. Release data extraction uses multiple methods: title from dedicated elements or first non-numeric text lines, artist from artist elements or "by [Artist]" patterns, release date from date patterns (MM/DD/YYYY or Month DD, YYYY), format from release type keywords, and price from currency patterns. Artwork URLs are extracted from image elements. Release status is determined from text indicators ("in collection", "purchased", "owned", "wishlist", "want") and local tracking for wishlist and follow statuses. The seen tracking system uses GM_setValue to store release IDs that have been displayed, preventing duplicate "NEW" markers. The auto-refresh uses setInterval with a user-configurable interval, and a MutationObserver watches for page updates. All settings, wishlist, follow, and seen data are persisted using GM_setValue.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Bandcamp may update its site structure, which could affect the script's ability to detect release data — updates will be released as needed. All release data, wishlist tracking, follow status, and seen markers are stored locally in your browser and are never transmitted externally. The "Follow Artist" tracking is local only and does not sync with Bandcamp's follow system. The script reads data from the visible page and does not access any data beyond what is visibly presented. The "Open" button performs a search and may not always find the exact release. This tool is for informational purposes only and is not affiliated with Bandcamp.