video-podcast

Turn any video URL into a podcast episode. Publishes a valid RSS feed to Cloudflare R2 that can be subscribed to in Apple Podcasts, Overcast, Pocket Casts, and any podcast app.

Supports YouTube, X (Twitter), and the ~1,000 other sites that yt-dlp supports.

First-time Setup

1. Install dependencies

CODEBLOCK0

2. Create a Cloudflare R2 bucket

1. 1. Sign up at cloudflare.com (free tier is sufficient)
2. Go to R2 Object Storage → Create bucket
3. Name it anything — e.g. INLINECODE0
4. Enable Public access on the bucket (R2 → bucket → Settings → Public Access → Enable)
5. Note the r2.dev public URL shown (e.g. https://pub-abc123.r2.dev)

3. Create an R2 API token

1. 1. R2 → Manage R2 API Tokens → Create token
2. Set permissions: Object Read & Write on your bucket
3. Note the Access Key ID and Secret Access Key
4. Note your Account ID from the dashboard top-right

4. Configure the skill

Run the interactive setup:

CODEBLOCK1

Or add these to ~/.openclaw/.env manually:

CODEBLOCK2

5. Add a cover image (optional but recommended)

Podcast apps display a 1400×1400px JPEG as artwork. Upload one to your bucket:

CODEBLOCK3

The image must be named cover.jpg in the root of your bucket.

Usage

Add a single video

CODEBLOCK4

Sync a YouTube playlist

Add all videos from a playlist that aren't already in the feed:

CODEBLOCK5

The playlist ID is the part after list= in the YouTube URL.

List episodes

CODEBLOCK6

Get the RSS feed URL

CODEBLOCK7

Remove an episode

CODEBLOCK8

How It Works

1. 1. yt-dlp fetches the best available audio stream from the source URL — no browser automation, no screen capture.
2. ffmpeg converts the audio to MP3 (VBR ~130kbps).
3. The MP3 is uploaded to your Cloudflare R2 bucket with a 7-day public cache header.
4. INLINECODE5 is rebuilt and uploaded with no-cache headers so podcast apps always see the latest version.
5. Your podcast app polls the feed URL periodically and downloads new episodes automatically.

Storage & State

Supported Sources

Any URL that yt-dlp supports, including:

• - YouTube — videos and playlists
• X (Twitter) — public video tweets
• Vimeo, SoundCloud, Twitch clips, Reddit videos
• Full list of 1,000+ supported sites

Troubleshooting

ffmpeg not found
CODEBLOCK9

SSL errors with R2
Make sure you're using Python 3.10+ with OpenSSL 3.x. On macOS the system Python (/usr/bin/python3) uses LibreSSL which may not work. Install Python via Homebrew:
CODEBLOCK10

Age-restricted YouTube videos
yt-dlp needs your browser cookies:

yt-dlp --cookies-from-browser chrome "https://youtube.com/watch?v=..."

X/Twitter videos fail
Public tweets work without auth. Private accounts require cookies:
CODEBLOCK12

Episode not appearing in podcast app
Most podcast apps cache the feed for 1–24 hours. Force a refresh in the app, or check the feed directly: python3 video_podcast.py feed

OpenClaw Agent Usage

When used via the OpenClaw agent, trigger phrases include:

• - "Add this to my podcast feed: [URL]"
• "Add this video to my podcast"
• "Sync my podcast from playlist [ID]"
• "What's in my podcast feed?"
• "Remove [URL] from my podcast"

The agent will run the appropriate subcommand and report back the result.