offshore-podcast 0.2.1

A local-first podcast feed generator and editor.

offshore

Homepage ･ Repository ･ PyPI package ･ Tickets

Local-first podcast feed generator and editor. Manage show metadata and episodes locally, generate a standards-compliant RSS 2.0 + iTunes feed, and serve or publish the output anywhere.

Screenshots^†

Requirements

Python 3.11 or later.

Installation

pip install offshore-podcast

Or from source:

pip install -e .

Quick start

offshore serve          # opens the web UI at http://127.0.0.1:8765

Data layout

Every show lives in its own subdirectory inside the shows root.

~/offshore/              # default shows root (configurable)
  <slug>/
    <slug>.json          # show metadata + all episodes
    <slug>.lock.json     # feed stability lock (GUID / pub_date history)
    <slug>.report.json   # check results + probe cache (generated)
    podcast.xml          # generated feed
    rss.xsl              # generated stylesheet

<slug>.json is the primary data file. It stores everything that ends up in the feed: show title, description, language, categories, cover image URL, feed self-link, episodes with their audio URLs, shownotes, persons, and more.

<slug>.lock.json records each episode's GUID and pub_date when it is first saved. Any later change to these values through a normal save is rejected, protecting subscribers from duplicate entries. Use offshore republish to intentionally move an episode date.

<slug>.report.json holds the result of the lastest check run and per-episode audio probe results. It's auto generated and to be read by offshore and should not be manually edited.

Documentation

Development

pip install -e ".[dev]"
python -m pytest

^†: The example feed in the screenshots are from Preserve This Podcast.