Today, on November 9th 2020, after 1690 days of maintenance, 204 commits and 59 releases, I stop working on this project due to lack of time.

I would probably rather start a rewrite in dart than trying to fix what I don’t like about this project. Back in October 2020 I tried to collect my thoughts on the status and they are mostly still valid.

I case you want to step up as maintainer of this project, get in touch! (

Unmaintained Gem Version

A podcast publishing extension for the static site generator Jekyll


You generate a static web site for your podcast on your own computer, test drive it and sync it to your web space.

No Wordpress, PHP, Ruby other scripting language, database management system or any other dynamic component is needed on your server. This increases security immensely.

Tell me more!

If you want to take a look: See (and listen to) Stefan’s podcast Aua-Uff-Code!.

The page you will get when you follow the installation instructions looks like this one:


Technically speaking, jekyll-octopod is a Jekyll plugin and a Ruby Gem. It contains of scripts, templates, helpers and extensions to publish your podcasts in the cool text file lover’s way.

If you are not afraid of the command line on your computer and text files are the stuff that heat up your geeky little heart, jekyll-octopod may be worth a trial to publish your podcasts.

The underlying assumptions of jekyll-octopod are that static content should be delivered statically and text files are the perfect way to handle podcast metadata. Jekyll-octopod makes it easy to generate and deploy a website with feeds for your podcast out of one textfile and at least one audio file per episode.


jekyll-octopod brings innately:

  • iTunes-ready paged episode feeds for different file formats (e.g. mp3, ogg, m4a)
    • contributors on episode level
    • image on episode level
    • enclosures have proper guids created
    • generator string identifies jekyll-octopod as feed generator
  • a ready to use Bootflat and Twitter Bootstrap-based, responsive (i.e. mobile friendly) layout modifiable to your heart’s desire.
  • Flattr support on the website and in the episode feed.
  • Twitter integration on the website.
  • comments via Disqus or
  • comments via Isso.
  • Podigee Web Player.
    • Easy chaptermarks
    • Fast-forward & rewind 30s
    • Multiple playback speeds: 0.5x, 1.5x, 2x
  • Podlove Subscribe Button for easy podcast subscription on any operating system, including mobile phones.
  • https compatibility
  • Google search integration
  • Easy show notes creation
  • Admin interface provided by Jekyll Admin

Is this production ready?

We use it in production, so we believe it is. But it is very likely, that it still contains bugs. And there is no guarantee that behavior will not change with the next update :-).

Hopefully you are brave enough to play with this cute little toy anyway.


Detailed documentation is provided on the following pages:

  1. Prerequisites
  2. Installation
  3. Configuration
  4. Demo
  5. Usage
  6. Command Line Tool
  7. Theming
  8. Liquid Filters
  9. Post structure
  10. Contributions
  11. Credits
  12. License
  13. Code of Conduct

You will find a link to the next page in the suggested reading track at the bottom of each page.

Continue reading with Prerequisites.


Stefan Haslinger

Credits go to lots of people and projects.