Buzzsprout Bulk Episode Metadata Updater

WHAT IT DOES

This productivity tool revolutionizes Buzzsprout podcast episode management by enabling bulk metadata updates across multiple episodes simultaneously. It scans your current Buzzsprout episode management page, extracting all visible episodes including their titles, IDs, publication dates, episode types, explicit status, season numbers, and episode numbers. You can then filter episodes by title or episode type, select individual episodes or use the select-all-filtered feature, and apply bulk metadata updates including episode type (Full, Trailer, Bonus), explicit status (Clean, Explicit), season numbers, or episode numbers with automatic sequential numbering. The script handles the entire workflow automatically, opening each episode's edit modal and applying updates through Buzzsprout's own UI controls with proper event propagation.

WHERE IT RUNS

This script operates on Buzzsprout podcast episode pages at *://*.buzzsprout.com//episodes, *://*.buzzsprout.com//podcast/episodes, and *://*.buzzsprout.com/admin//episodes. It integrates as a floating panel on the left side of your browser window when you navigate to your Buzzsprout episode manager. The tool works with Buzzsprout's dynamic interface, detecting episodes regardless of how they're rendered on the page and adapting to Buzzsprout's frequent UI changes. The panel automatically detects your podcast ID from the page context for per-podcast settings persistence.

HOW TO USE

Navigate to your Buzzsprout episode management page (any of the supported URLs).

The panel appears automatically on the left side of the screen.

Click "Refresh" to load all visible episodes from the current page.

Use the filter input to search episodes by title.

Use the episode type filter to show only Full, Trailer, or Bonus episodes.

Check the boxes next to episodes you want to modify, or use "Select All Filtered".

Select the metadata field to update: "Episode Type", "Explicit Status", "Season Number", or "Episode Number".

For Episode Type: choose "Full", "Trailer", or "Bonus" from the dropdown.

For Explicit Status: choose "Clean" or "Explicit" from the dropdown.

For Season Number: enter the season number (auto-saves recent seasons).

For Episode Number: enter the starting number (episodes will be numbered sequentially).

Click "Apply Metadata to Selected" to begin the batch update process.

The status bar shows progress and any errors encountered during processing.

REACT EVENT PROPAGATION MECHANISM

The tool succeeds where browser extensions fail because it operates directly within Buzzsprout's own JavaScript context, bypassing cross-origin restrictions that prevent external extensions from accessing Buzzsprout's internal React state. It uses React event propagation by dispatching both "input" and "change" events with proper bubbling flags (bubbles: true), ensuring Buzzsprout's virtual DOM reconciles the metadata changes correctly and persists the updates. The script implements a concurrency cap of 4 simultaneous operations with 300ms spacing between each, preventing Buzzsprout's rate limiting from blocking requests while maintaining efficient throughput. The tool intelligently detects form fields by scanning for name attributes, placeholder text, and data-testid attributes, using comprehensive error recovery for each episode operation. For episode number updates, the script automatically increments the number for each selected episode in order, enabling bulk renumbering of entire seasons.

THE PANEL

The floating panel is draggable to any position on screen and remembers its location between sessions using GM_setValue. It automatically collapses to a small icon when minimized and expands on hover or click. The panel is resizable to suit your workspace needs and can be dismissed with the Escape key. It snaps to the left edge by default but can be positioned anywhere, with position persisted across browsing sessions for consistent placement. All settings persist automatically across sessions, including your recently used metadata presets (episode type and explicit status), and season number history per podcast.

PLEASE NOTE

This script requires the free BotGentz extension to run user scripts on Buzzsprout. Buzzsprout frequently updates its episode management interface, which may temporarily break functionality; updates are released regularly to maintain compatibility. The script only reads visible episode information from the page and does not store or transmit any data externally. All processing occurs locally in your browser. Metadata updates are applied exactly as configured; verify your changes before bulk application to avoid unintended modifications. For episode numbers, ensure the starting number is correct as the script will auto-increment for each selected episode in order. The script remembers your recently used season numbers for quick access in future sessions.