mxpv

podsync: Turn Video Channels into Podcast Feeds

Podsync converts YouTube and Vimeo channels, playlists, and user videos into podcast feeds that work with podcast apps. It is suited to people who want scheduled downloads, offline listening, and control over a self-hosted feed.

View on GitHub Compare
Stars
2k
Forks
316
Stars, last 30 days
+18

Our take

Health score

41/100

How it is scored
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.

Selected snapshot

Stars

1,989

Forks

316

Change 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.