youtube2freshrss/README.org

31 lines
1.5 KiB
Org Mode

#+title: YouTube2FreshRSS
One-Way-Synchronization of your YouTube subscriptions to FreshRSS.
* Requirements
- YouTube channel/account with a /public/ subscription list
- [[https://www.freshrss.org/][FreshRSS]] instance
- [[https://rss-bridge.github.io/rss-bridge/][rss-bridge]] instance
- Python 3
* Features
- Adds YouTube subscriptions as rss-bridge Atom feeds to the category "YouTube" in your FreshRSS instance
- Removes YouTube Atom feeds from the YouTube category in FreshRSS if they are (no longer) YouTube subscriptions
* Shortcomings
- I did not implement support for using OAuth2 with Google. Therefore it is only possible to access public resources and this is the reason why the channels subscription lists needs to be public.
- Perhaps many more that I don't know/mind at the moment.
* Setup
- Create a new project in the [[https://console.cloud.google.com/apis/dashboard][Google Cloud Console]] and follow the [[https://support.google.com/googleapi/answer/6158862?hl=en&ref_topic=7013279][instructions to get an API key]]
- Enable the YouTube bridge in rss-bridge (if necessary)
- Copy =config.example.json= to =config.json= and fill it out
- (optional) Create a Python virtual environment with =python3 -m venv venv= and activate it
- Install Python requirements with =pip install -r requirements.txt=
- Execute the program with =python youtube2freshrss.py=
- (optional) Set up a Cron job for running the =run.sh= once a day with the working directory as first argument