ytpodgen 0.2.2

turns YouTube live streams into podcasts

ytpodgen - turns YouTube live streams into podcasts

prerequisite

• python3 and pip

first time setup

python3 -m pip install --user ytpodgen

Set environment variable SLACK_WEBHOOK_URL, if you want Slack notification.

If you want to upload files to Cloudflare R2 as well, don't forget to set three environment variables for Cloudflare R2.

• R2_ENDPOINT_URL
• R2_ACCESS_KEY_ID
• R2_SECRET_ACCESS_KEY

For now, R2 bucket name must be podcast.

examples

wait for new livestream, and once on the air, record it and generate podcast RSS in background

TITLE=<title> ; #title for your podcast
LIVEURL=<liveurl> ; #YouTube live URL that ends with "/live"
HOSTNAME=<hostname> ; #hostname to serve files from
screen -dmS ${TITLE} ytpodgen --liveurl ${LIVEURL} --title ${TITLE} --hostname ${HOSTNAME}

When completed, ytpodgen will wait for another livestream. Since all the waiting might take a while, I prefer running this in background using screen.

Why not upload them as well!?

You can pass --upload-r2 argument to enable file uploadig to Cloudflare R2. By enabling it, mp3s/RSS are uploaded to Cloudflare R2.

For example, by running the commands below , you create a screen session that waits for YouTube livestream on the given URL and saves the data under current directory if there is a livestream.

TITLE=<title> ; #title for your podcast
LIVEURL=<liveurl> ; #YouTube live URL that ends with "/live"
HOSTNAME=<hostname> ; #hostname to serve files from
screen -dmS ${TITLE} ytpodgen --upload-r2 --liveurl ${LIVEURL} --title ${TITLE} --hostname ${HOSTNAME}

I just want to generate RSS from mp3 files, no download/upload needed

TITLE=<title> ; #title for your podcast
HOSTNAME=<hostname> ; #hostname to serve files from
ytpodgen --title ${TITLE} --hostname ${HOSTNAME}

This generates index.rss file under current directory and exits.

Why only Cloudflare R2, and not other S3-compatible cloud storage?

Because:

• It offers free tier for up to 10GB of storage space per month
• With Cloudflare Worker, basic auth can be applied to the uploaded files that are made public

how I configured basic auth on Cloudflare R2 using Cloudflare Workers

1. connected a custom domain to my R2 bucket, to make the bucket public. docs
2. configured a basic auth worker by following steps described here.
3. replaced the plaintext declaration of password with worker env var. docs
4. added a trigger(custom domain route) to the basic auth worker. docs

TODO/IDEAS

• replace Click package with argparse (argparse is lightweight and suits ytpodgen well) ref: 1
• simplify basic auth on R2 bucket e.g. 1 2
• log when download has started
• add an option to specify output path
• use boto3 for uploading files in order to remove rclone
• generate rss feed with python code in order to remove dropcaster
• embed yt-dlp into ytpodgen, instead of calling it via docker
• use --live-from-start option for yt-dlp if the stream has already started
• package this app using poetry so that I can install this using pip
• introduce Click for this project