Converts a YouTube or Twitch channel into a full blown audio podcast feed.
- Completely converts the VoDs into a proper podcast RSS that can be listened to directly inside the client.
- The VoDs are not downloaded on the server, so no need for storage while self-hosting this app.
- VoDs are transcoded to MP3 192k on the fly by default, tested to be working flawlessly even on a Raspberry Pi 3-4.
- also works on standard rss podcasts feed if you want to have a lower bitrate version to save mobile data.
- Youtube channel avatar is not present and results are limited to 15 when no YouTube API key is set.
- just go where you hosted vod2pod and you will find an easy to use UI to generate the feed
- In a web browser go to where you hosted vod2pod, es: http://myserver.com/ or http://localhost/
- In the web page that opens paste the channel you want to convert to podcast and copy the generated link.
- Optionally goto : http://myserver.com/transcodize_rss?url=channel_url
- An RSS will be generated.
- Replace
channel_url
with the URL of the YouTube or Twitch channel you want to convert into a podcast.- YouTube:
http://myserver.com/transcodize_rss?url=https://www.youtube.com/c/channelname
- Twitch:
http://myserver.com/transcodize_rss?url=https://www.twitch.tv/channelname
- RSS/atom feed:
http://myserver.com/transcodize_rss?url=https://feeds.simplecast.com/aU_RzZ7j
- Add the domain to the whitelist. See configurations below
- YouTube:
- find a tutorial on how to add an rss feed to your favorite podcast app
- Twitch: Get your SECRET and CLIENT ID https://dev.twitch.tv/console
- YouTube: Enable more than 15 items in the RSS feed, channel avatar
- API key https://developers.google.com/youtube/v3/getting-started
- Enable API Access https://console.cloud.google.com/
- APIs & Services > Enable APIs and Services > Search "YouTube Data API"
See configurations below
git clone https://github.com/madiele/vod2pod-rss.git
- Install Docker Compose
- Precompiled images are available here for linux machines with arm64, amd64 and armv7 (raspberry pis are supported).
cd vod2pod-rss
nano docker-compose.yml
See configurations below
sudo docker compose up -d
sudo docker compose pull && sudo docker compose up -d
sudo docker system prune
- To get notifications of new release follow these instructions
ports
: "80:8080" (optional) Change 80 to another port if you already use the port 80 on your host- e.g. "81:8080" http://myserver.com:81/
YT_API_KEY
: Set your YouTube API key (works without but the feed is limited to 15)- e.g. YT_API_KEY=AIzaSyBTCCEOHm
TWITCH_SECRET
: Set your Twitch secretTWITCH_CLIENT_ID
: Set your Twitch client ID
Note: These can also be set using Docker .env files
TRANSCODE
: Set to "false" to disable transcoding, usefull if you only need the feeds (default: "true")MP3_BITRATE
: Set the bitrate of the trascoded stream to your client (default: "192")SUBFOLDER
: Set the the root path of the app, useful for reverse proxies (default: "/")VALID_URL_DOMAINS
: (optional) Set a comma separated list of domain urls that are allowed to be converted into RSS (defaults to YouTube and Twitch urls)
These projects were fundamental for the success of vod2pod-rss, originally they handled the feed generation for youtube and twitch, now this is all done by vod2pod-rss internally so they are not used anymore, but were still helpful to get vod2pod-rss up and running fast.
- Youtube support was possible thanks to the cool podtube fork project by amckee consider dropping him a star.
- Twitch support was possible thanks to my fork of lzeke0's TwitchRSS drop a star to him too!
This is a passion project, and mostly made for personal use, but if you want to gift a pizza margherita, feel free!
check the CONTRIBUTING.md to find a tutorial on how to setup your enviroment for develpment