Podswamp is a tool for building navigable, themed sites from Libsyn hosted podcasts. It does not serve any podcast files itself, but will create a site with in-build players based around the metadata contained in the Libsyn RSS feed.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.




Podswamp: extracts guest information and builds a site from a provided public Libsyn RSS and configuration JSON file. The minimum requirement for a configuration file is the URL of a Libsyn RSS feed. This information should be placed in a file named project.json

    "rss": "<libsyn rss url>"

This will generate a site using the default templates and styles without any guest-based pages. In order to parse guest information from the podcast titles additional information will need to be provided including regular expressions and terms to exclude.


Installation of podswamp requires Python 3 and setuputils.

A copy of podswamp should be downloaded and unpacked, or cloned. From within the unpacked/cloned podswamp run:

python3 setup.py install

to install.

Once installed podswamp can be run using:

podswamp <target podswamp project folder>


The basic usage of Podswamp involves creating a project folder and a project.json configuration file within it.

From within the project folder run

podswamp .

To process the configuration and builds the HTML of the site in a folder called, fittingly enough, html.


The podswamp-examples project contains a number of podswamp setups for a few popular podcasts. It wil act as a guide on how to setup sites, demonstrating the title parsing mechanisms for extracting the guest information as well as using bespoke styling and templates.

They will act as a reference while we add better documentation for Podswamp as a whole.