Podcaster — Podcast Publishing Skill

Project Location

/Users/damir/dev/pico/podcaster

What This Does

Publishes audio files as podcast episodes to a personal RSS feed hosted on Cloudflare R2 + Workers.

CLI Commands

All commands run from cli/ directory:

# Initialize feed (first time only)
deno run -A publish.ts init --title "Podcaster" --author "Damir" --email "email@example.com" --base-url "https://podcaster.<account>.workers.dev"

# Publish an episode
deno run -A publish.ts publish --title "Episode Title" --audio /path/to/file.mp3 --description "About this episode" --date 2026-02-14

# List episodes
deno run -A publish.ts list

# Delete an episode
deno run -A publish.ts delete --id "2026-02-14-episode-title"

Publishing Workflow

1. •Confirm audio file path and episode title with user
2. •Run the publish command from the cli/ directory
3. •Verify the episode appears in the feed: deno run -A publish.ts list
4. •Feed URL: check episodes.json in R2 for the configured baseUrl

Optional Flags

• •--description — Episode description (defaults to title)
• •--date — Publication date as YYYY-MM-DD (defaults to today)
• •--episode-type — full (default), trailer, or bonus
• •--duration — Manual duration as HH:MM:SS (auto-detected via ffprobe if available)

Notes

• •Audio files must be MP3
• •Duration is auto-detected if ffprobe is installed
• •The feed rebuilds automatically on every publish/delete
• •R2 bucket name: podcaster