Our take
- Activity
- 38
- Community
- 55
- Issues
- 21
- Pull requests
- 50
+18 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,989Forks
316Change since Nov 17, 2026: +8 stars·0 forks
Overview
Podsync turns videos from YouTube and Vimeo into podcast feeds, so listeners can follow them in podcast applications rather than relying on those platforms' viewing experience. Podcast apps can then provide features such as automatic episode downloads, playback-position memory, device sync, and offline listening.
It is a self-hosted Go service for individuals or operators who want to configure and serve feeds themselves. It can run as a binary or in Docker, with feed configuration and media storage managed by the operator.
Key Features
- Creates podcast feeds from YouTube and Vimeo channels, playlists, and user videos.
- Configures feeds for audio or video, quality, and maximum video height.
- Encodes audio as MP3 and schedules updates using cron expressions.
- Filters episodes by title or duration and can retain only a configured number of recent episodes.
- Customizes feed artwork, category, and language, with OPML export.
- Supports hooks, API key rotation, and automatic yt-dlp updates.
- Runs on Windows, macOS, Linux, Docker, and ARM systems.
Use Cases
- Podcast listeners can follow a video channel in their preferred podcast app and download new episodes for offline listening.
- Self-hosters can operate feeds for selected channels or playlists instead of depending on a hosted conversion service.
- Users who want audio-only listening can configure feeds for audio and MP3 encoding.
- Operators managing several feeds can use cron schedules, episode filtering, cleanup, and custom feed details to tailor their output.
Getting Started
Create a config.toml with a feed URL and the required API key, then run the container:
docker run -p 8080:8080 -v "$(pwd)/data:/app/data/" -v "$(pwd)/db:/app/db/" -v "$(pwd)/config.toml:/app/config.toml" ghcr.io/mxpv/podsync:latest
See the README and config.toml.example for configuration and other deployment options.
Considerations
- You need API credentials for the services you use. The README documents obtaining YouTube and Vimeo tokens and also lists SoundCloud and Twitch API key settings.
- Running the binary directly requires
yt-dlp,ffmpeg, and Go to be available on the system. Docker is another supported deployment option. - Podsync operates the feed and storage itself, so setup includes configuration, writable storage, and a reachable server endpoint for episode links.
- The repository README describes a fork that maintains compatibility with upstream while adding filename templates and a one-time filename migration. Non-dry-run filename migration is currently limited to local storage.
Found this useful?
Share it with someone who would like podsync.