27 Mar 2020 ~ 4 min read

How To Host Your Podcast For Free On Github Pages

Do you have a story to tell and want to share it with the world but do not know where to start? Are you a developer looking to start a tech podcast? Are you looking to save money for hosting? Well this article is for you!

TL;DR; You can fork this repo and customize it for your podcast!

Github source

Github Pages allows you to host any website for free on Github. You can host any kind of file or content and will be distributed with Github CDN around the world. You can even setup your Podcast to release new content with Github Actions for each new episode.

Create New Repo

If you already familiar with Github you can skip this step.

How to create a new Github repository.

Login or Create a free account for Github and follow the instructions for creating the repo.

Clone the Repo

Now that you have the repo created on Github, download the project using Github Desktop.

How to clone a repository from Github.

After it finishes downloading you can open up the project in your favorite text editor. In this example we will be using VSCode.

Download Visual Studio Code

Create the Website

You can create the website with whatever tech stack you wish but in this example we will be using Flutter.

You can skip this step if you do not want an online player.

Learn about Flutter.

Open up the project if you haven’t already with VSCode and open the terminal and type the following:

flutter create player

Once the process finishes then you can edit the application UI. Make sure you have Flutter installed.

How to install Flutter.

Edit the website files to the following:

Flutter podcast template.

Setting up Github Actions

Create a new Github Action that will release the new episode pushed to the master branch. If you chose not to have a podcast player and just want to host the files then you can add the audio files and the rss feed directly to the gh-pages or master branch and the files will be hosted instantly. Regardless make sure you have a file call .nojekyll so the web deployment will be much faster.

Custom Domain

If you want to have your podcast hosted with a custom domain you can easily do this with Github pages. Follow this guide to set up your custom domain:

Custom domain on Github Pages.

Releasing new Content

When you have a new episode to release the steps are very simple. Make sure to export your audio file to mono and use mp3 format so it is smaller that 100mb otherwise you will need to set up Git LFS for the repo.

Setup Git LFS for Github repository.

Put the new mp3 audio file in the “player/web/audio” folder. Now edit the RSS feed which is located at “player/web/feed.xml” and add the following:

<?xml version="1.0" encoding="UTF-8" ?>
<rss xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:rawvoice="http://www.rawvoice.com/rawvoiceRssModule/" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
    <title>Creative Engineering</title>
    <googleplay:author>Rody Davis, Norbert Kozsir</googleplay:author>
    <rawvoice:location>San Francisco, California</rawvoice:location>
    <author>Rody Davis, Norbert Kozsir</author>
    <itunes:author>Rody Davis, Norbert Kozsir</itunes:author>
    <itunes:category text="Technology" />
      <title>Creative Engineering</title>
      <itunes:name>Rody Davis</itunes:name>
    <copyright>Rody Davis Productions 2020</copyright>
    <description>Exploring Flutter, VR, AR, Cross-Platform Projects</description>
    <googleplay:image href="https://rodydavis.github.io/podcast-player/img/icon.jpg" />
    <pubDate>Mon, 13 Apr 2020 13:00:00 PDT</pubDate>
    <itunes:image href="https://rodydavis.github.io/podcast-player/img/icon.jpg" />
      <author>Rody Davis, Norbert Kozsir</author>
      <itunes:author>Rody Davis, Norbert Kozsir</itunes:author>
      <title>Flutter Desktop/Web and VR</title>
      <pubDate>Mon, 13 Apr 2020 13:00:00 GMT</pubDate>
      <enclosure url="https://rodydavis.github.io/podcast-player/audio/01-create-eng.mp3" type="audio/mpeg" length="34216300" />
      <guid isPermaLink="false">cepod01</guid>
Norbert Kozsir - @norbertkozsir



Rody Davis - @rodydavis





Our podcast player: 


For every episode you just have to add a new item to the feed and change the info for the episode. I would suggest putting the new episodes at the bottom.

    <pubDate>Mon, 13 Apr 2020 13:00:00 GMT</pubDate>        
    <enclosure url="LINK\_TO\_AUDIO\_FILE" type="audio/mpeg" length="34216300" />        
    <guid isPermaLink="false">cepod01</guid>      
    Show Notes Here!         


Once your Github Action is finished building you now have an RSS feed that you can use to submit to Apple Podcasts, Google Podcasts and Spotify for Podcasters.


You can also use this RSS Feed link to support any podcast player!


Hopefully you can see now how easy it is to host your podcast for free on Github Pages. You can find the final code for this example here:

Final Project.

Live Example

My “Creative Engineering” podcast is hosted using this technique: