Skip to content

Vod2Pod-RSS converts a YouTube or Twitch channel into a podcast with ease. It creates a podcast RSS that can be listened to directly inside any podcast client. VODs are transcoded to MP3 on the fly and no server storage is needed!

License

Notifications You must be signed in to change notification settings

TeslaOwnerTips/vod2pod-rss

 
 

Repository files navigation

vod2pod-rss tests stable image beta image

Converts a YouTube or Twitch channel into a full blown audio podcast feed.

Features

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

Limitations

  • Youtube channel avatar is not present and results are limited to 15 when no youtube API key is set

Usage

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.

Installation

install with docker

twitch support (optional)

get your SECRET and CLIENT ID from twitch

https://dev.twitch.tv/console

better youtube support (optional)

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

running the server

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

new releases notifications

To get notifications of new release be sure to watch the repo and set a custom notification only on new releases.

when you want to update

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

Configuration

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)

Honorable mentions

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:

Donations

This is a passion project, and mostly made for personal use, but if you want to gift a pizza margherita, feel free!

"Buy Me A Coffee"

Contributing

check the CONTRIBUTING.md to find a tutorial on how to setup your enviroment for develpment

About

Vod2Pod-RSS converts a YouTube or Twitch channel into a podcast with ease. It creates a podcast RSS that can be listened to directly inside any podcast client. VODs are transcoded to MP3 on the fly and no server storage is needed!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 84.1%
  • HTML 11.1%
  • Dockerfile 2.7%
  • Makefile 1.6%
  • Shell 0.5%