mayobytes / podcast-qa

A very simple server to self-host a podcast feed. Intended for internal QA.

podcast-qa

This is a tool I wrote to self-host a QA version of my podcast that I can share with friends and cohosts for feedback before content goes live on my main feed.

Dependencies

This requires python3 to run, and tmux if you use the start/stop scripts.

Ubuntu/Debain via apt

sudo apt install python3 tmux

MacOS via Homebrew

brew install python tmux

Usage

This server simply hosts an RSS feed (one you will have to create) named "feed.xml", an image/thumbnail named image.png, and mp3 episodes. It looks for the feed and image files in the same directory it is running in and the mp3 episodes should be in a sub-directory called "episodes".

Check out Apple's guide to RSS for more information on how to write your own feed.

Note that this is NOT intended for hosting a public facing show. I'm not a backend dev and the code intentionally does not cache anything so you can live change content without having to restart the server. I have also had weird issues around streaming on some apps. Downloading the episodes works fine there are currently some oddities around scrubbing through content that is being streamed without downloading.

Starting

./start.sh

Stopping

./stop.sh

All these scripts do is start the python server via tmux under the session "podcast-qa". For more information (including how to attach to the session to view logs) checkout this tmux guide.