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 to the root of the server es: myserver.com
and paste the channel you want to convert to podcast and copy the generated link.
you can also build the url manually just add /transcodize_rss?url=channel_url
to your server path, and an RSS will be generated. Replace channel_url
with the URL of the YouTube or Twitch channel you want to convert into a podcast.
Example youtube: myserver.com/transcodize_rss?url=https://www.youtube.com/c/channelname
Example twitch: myserver.com/transcodize_rss?url=https://www.twitch.tv/channelname
Example rss/atom feed (be sure to add the domain to the whitelist): myserver.com/transcodize_rss?url=https://feeds.simplecast.com/aU_RzZ7j
Just add the link to your podcast client.
get your SECRET and CLIENT ID from twitch
only needed if you want youtube channels avatar and better playlist support
get your youtube api key here
https://developers.google.com/youtube/v3/getting-started
precompiled images are here for linux machines with arm64, amd64 and armv7 (raspberry pis are supported).
use docker compose with precompiled image
git clone https://github.com/madiele/vod2pod-rss.git
cd vod2pod-rss
edit docker-compose.yml
with your SECRET and CLIENT_ID for youtube and twitch if needed
(in the file you will find also optional parameters like bitrate).
If you host other stuff on you machine you might want to change the host port from 80 to something else:
es: to change the host port to 1234 edit - "80:8080"
to - "1234:8080"
to edit the file do
nano docker-compose.yml
save and
sudo docker compose up -d
To get notifications of new release be sure to watch the repo and set a custom notification only on new releases.
run this inside the folder with docker-compose.yml
sudo docker compose pull && sudo docker compose up -d
then run this to delete the old version from your system (note: this will also delete any other unused image you have)
sudo docker system prune
You can set the following environment variables:
TRANSCODE
: Set to "false" to disable transcoding, usefull if you only need the feeds (default: "false")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 domains urls that are allowed to be converted into RSS (defaults to yotube and twitch urls)
This projects were fondamental 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. Those project were:
- 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