How paulmndn/yt2pod works
yt2pod is a self-hosted web app that turns playlist or channel subscriptions into podcast feeds. Users manage subscription settings in the web UI; checks can be queued manually or run on a schedule. The worker runs yt-dlp downloads, records episodes and channel metadata, and the app serves RSS feeds and media files to podcast apps. SQLite stores subscriptions, episodes, and check status. The README documents the broader capabilities; the source excerpts show the principal calls, but not every UI template or integration detail.
Main entry points: __init__.py Web routes · downloader.py Download processing · worker.py Check scheduler · db.py SQLite database
Components 14
Web app
- App startup
yt2pod/__main__.py - Web routes
yt2pod/__init__.py - Web templates
yt2pod/templates
Subscription checks
- Check scheduler
yt2pod/worker.py - Download processing
yt2pod/downloader.py
Persistence and files
- SQLite database
yt2pod/db.py - Downloaded media
yt2pod/downloader.py
Podcast delivery
- RSS generation
yt2pod/feeds.py - Subscription feed
yt2pod/__init__.py - Media endpoint
yt2pod/__init__.py
Other components
- Browser user
- Podcast app
- yt-dlp
- YouTube
Connections 19
- App startup → Web routes: starts app
yt2pod/__main__.py - Web routes → Web templates: renders
yt2pod/__init__.py - Browser user → Web routes: manages subscriptions
README.md - Web routes → SQLite database: reads and writes
yt2pod/__init__.py - Web routes → Check scheduler: queues checks
yt2pod/__init__.py - App startup → Check scheduler: starts worker
yt2pod/__main__.py - Check scheduler → SQLite database: lists enabled IDs
yt2pod/worker.py - Check scheduler → Download processing: runs subscription
yt2pod/worker.py - Download processing → SQLite database: checks and records episodes
yt2pod/downloader.py - Download processing → yt-dlp: configures and runs
yt2pod/downloader.py - yt-dlp → YouTube: fetches playlist videos
README.md - Download processing → Downloaded media: writes media files
README.md - Web routes → RSS generation: builds RSS
yt2pod/__init__.py - RSS generation → Subscription feed: generates XML
yt2pod/feeds.py - Web routes → SQLite database: loads feed episodes
yt2pod/__init__.py - Podcast app → Subscription feed: fetches feed
README.md - Podcast app → Media endpoint: fetches enclosures
README.md - Web routes → Media endpoint: serves files
yt2pod/__init__.py - Media endpoint → Downloaded media: reads media files
yt2pod/__init__.py