https://offshore.pressed.press/DOC/ DOC /DOC/ Documentation https://offshore.pressed.press/PY/ PY /PY/ A working Python 3.11+ installation Requirement offshore is written in Python and thus requires Python to run. offshore should generally be installed through the pip package manager. Guide for installing Python on your system is available here. Installation https://offshore.pressed.press/INST/ INST /INST/ Install from PyPI pip install offshore-podcast https://offshore.pressed.press/INST2/ INST2 /INST2/ Install from source Usage https://offshore.pressed.press/WUI/ WUI /WUI/ Web UI All offshore features are accessible via its web UI. To launch, simply run offshore serve. The default serving port is 8765. To override the serving host or port, run The web UI provides: https://offshore.pressed.press/WUI1/ WUI1 /WUI1/ Dashboard Overview of the podcast. Generate feed, run check, and perform quick actions per check results. https://offshore.pressed.press/WUI2/ WUI2 /WUI2/ Show settings Edit all show-level fields including cover image, categories, feed self-link, and output path. Show cover will be automatically verified against Apple Podcasts’ standard to ensure compatibility. https://offshore.pressed.press/FT1/ FT1 /FT1/ Set consistent feed output path per show Feature User can set a consistent output path of the feed XML file in per-show configuration. This enables serving the feed directly when using offshore on a server, or integrate it in other workflow. The path value is stored in key . On first feed generation of a show, the user will be prompted to confirm or change the default feed output path. It can be changed in show settings anytime. https://offshore.pressed.press/CPRT/ CPRT /CPRT/ <copyright> tag offshore implements a semi-smart generation of <copyright> tag. The copyright string fallback to key if not set. Two options for auto injecting year to the copyright string:Current year: <copyright>2026 offshore</copyright> Year range: <copyright>2019-2026 offshore</copyright>, where the first episode on record will populate the first year. https://offshore.pressed.press/PPL/ PPL /PPL/ People roster Feature A list of people entries to be included in episodes is maintained in show settings, and will automatically emit <podcast:person>, and <itunes:author> tags in proper locations on feed generation. https://offshore.pressed.press/PPL1/ PPL1 /PPL1/ Schema v2 › Universal people entries in show metadata Show and episode participants are now all selected from entries linked to people roster at show or episode level and stored in key . <itunes:author> and <podcast:person> tags are automatically derived from the people entries in show metadata. The option to delete all data of a show is located at the bottom of this page. https://offshore.pressed.press/WUI3/ WUI3 /WUI3/ Episode editor Episode editor can be launched from the “New episode” button on the top navigation, or when editing an existing episode. User can enter all metadata of an episode in this page. https://offshore.pressed.press/MD/ MD /MD/ Markdown shownotes reference https://commonmark.org/ offshore accepts commonmark markdown content for shownotes. It will be translated to proper HTML format on feed generation. HTML shownotes from external feed will be converted into markdown on import with markdownify. offshore supports the following list of markdown syntax. Syntax Format *Italic* or _Italic_ Italic **Bold** or __Bold__ Bold # Heading 1 or Heading 1 ## Heading 2 or Heading 2 or Hyperlink > Blockquote Blockquote ListListList OneTwoThree --- or *** `Inline code` with backticks Inline code with backticks Audio URL is checked for format and reachability on save. Episode artworks are also validated when newly set or changed. https://offshore.pressed.press/GUID/ GUID /GUID/ GUID Feature Globally unique identifiers (GUID) are unique identifiers for episodes. An episode’s GUID must remain unique and unchanged for it to be identified correctly. If an episode’s GUID is moodified in the feed, it will be recognized as a different episode. offshore generates uuidv5 GUIDs that fully compliant with the podcast namespace for each episodes created in offshore. This value is write-once and cannot be changed in anyway. For imported show, the GUID is inherited from the original feed and won’t be touched. All GUIDs are protected by <slug>.lock.json. https://offshore.pressed.press/WUI4/ WUI4 /WUI4/ Switch show https://offshore.pressed.press/FEATS/ FEATS /FEATS/ Core features https://offshore.pressed.press/CK/ CK /CK/ Check Feature https://offshore.pressed.press/CK2/ CK2 /CK2/ Check report https://offshore.pressed.press/FT3/ FT3 /FT3/ Image validation Feature Podcast and episode artworks are verified against Apple Podcast standards. Failing this check will produce notice to user, but won’t block feed generation. The automatic image validation is triggered in two occasions:when a new artwork url is added to a show, or an episode; or when a show or episode’s artwork url is changed. https://offshore.pressed.press/FT2/ FT2 /FT2/ <slug>.report.json Feature Check findings and audio probe results are stored in a separate <slug>.report.json file. This file will be automatically updated with checks representing the issues and things to improve in show metadata or assets. https://offshore.pressed.press/GEN/ GEN /GEN/ Feed generation Feature Based on the show metadata, offshore aim to generate podcast feed accurately and intelligently. offshore generates feed following RSS 2.0 specification, and incorporates Reference and Reference at the same time. offshore use markdown-it-py to translate markdown shownotes into HTML. The generated feed can be downloaded right away, or saved to a custom path configurable in the show settings. https://offshore.pressed.press/IMP/ IMP /IMP/ Importer feature https://offshore.pressed.press/PPL/ PPL /PPL/ People roster Feature A list of people entries to be included in episodes is maintained in show settings, and will automatically emit <podcast:person>, and <itunes:author> tags in proper locations on feed generation. https://offshore.pressed.press/PPL1/ PPL1 /PPL1/ Schema v2 › Universal people entries in show metadata Show and episode participants are now all selected from entries linked to people roster at show or episode level and stored in key . <itunes:author> and <podcast:person> tags are automatically derived from the people entries in show metadata. References https://offshore.pressed.press/APNS/ APNS /APNS/ Apple Podcasts namespace Reference https://help.apple.com/itc/podcasts_connect/#/itcb54353390 Apple proposed its own podcast RSS namespace in 2005, which is first of its kind to enable a standard delivery of podcast specific features. It’s still active and one of the most commonly used standard for podcast feeds. https://offshore.pressed.press/APAG/ APAG /APAG/ Apple Podcasts’ Artwork Guide Reference https://podcasters.apple.com/artwork-guide Apple Podcasts is the de facto most common podcast distributor and catelogue. Although RSS standards of podcast doesn’t have a hard requirement for artworks, fail to meet Apple Podcasts’ standards may causse your show not being displayed correctly on Apple Podcasts and many other services relying on it. Currently, Apple Podcasts’ standards for artworks are Size: 1400 × 1400 to 3000 × 3000 pixels. The largest size is preferred. File type: PNG (without alpha channel) or JPG. https://offshore.pressed.press/PCNS/ PCNS /PCNS/ Podcast Namespace Reference https://github.com/Podcastindex-org/podcast-namespace/ A wholistic rss namespace for podcasting, is widely supported by major podcast clients and services. It is part of the Podcasting 2.0 project. Context tianshi lechynte https://offshore.pressed.press/index/ index /index/ offshore offshore is a local-first podcast feed generator and editor. ︎☃ Explore podcasts powered by offshore! https://offshore.pressed.press/INFO/ INFO /INFO/ Project information source code: sr.ht/~lamons/offshore feedback: todo.sr.ht/~lamons/offshore discussion: lists.sr.ht/~lamons/offshore-discuss PyPI v0.5.2: pypi.org/project/offshore-podcast https://offshore.pressed.press/DOC/ DOC /DOC/ Documentation https://offshore.pressed.press/PY/ PY /PY/ A working Python 3.11+ installation Requirement offshore is written in Python and thus requires Python to run. offshore should generally be installed through the pip package manager. Guide for installing Python on your system is available here. Installation https://offshore.pressed.press/INST/ INST /INST/ Install from PyPI pip install offshore-podcast https://offshore.pressed.press/INST2/ INST2 /INST2/ Install from source Usage https://offshore.pressed.press/WUI/ WUI /WUI/ Web UI All offshore features are accessible via its web UI. To launch, simply run offshore serve. The default serving port is 8765. To override the serving host or port, run The web UI provides: https://offshore.pressed.press/WUI1/ WUI1 /WUI1/ Dashboard Overview of the podcast. Generate feed, run check, and perform quick actions per check results. https://offshore.pressed.press/WUI2/ WUI2 /WUI2/ Show settings Edit all show-level fields including cover image, categories, feed self-link, and output path. Show cover will be automatically verified against Apple Podcasts’ standard to ensure compatibility. https://offshore.pressed.press/FT1/ FT1 /FT1/ Set consistent feed output path per show Feature User can set a consistent output path of the feed XML file in per-show configuration. This enables serving the feed directly when using offshore on a server, or integrate it in other workflow. The path value is stored in key . On first feed generation of a show, the user will be prompted to confirm or change the default feed output path. It can be changed in show settings anytime. https://offshore.pressed.press/CPRT/ CPRT /CPRT/ <copyright> tag offshore implements a semi-smart generation of <copyright> tag. The copyright string fallback to key if not set. Two options for auto injecting year to the copyright string:Current year: <copyright>2026 offshore</copyright> Year range: <copyright>2019-2026 offshore</copyright>, where the first episode on record will populate the first year. https://offshore.pressed.press/PPL/ PPL /PPL/ People roster Feature A list of people entries to be included in episodes is maintained in show settings, and will automatically emit <podcast:person>, and <itunes:author> tags in proper locations on feed generation. https://offshore.pressed.press/PPL1/ PPL1 /PPL1/ Schema v2 › Universal people entries in show metadata Show and episode participants are now all selected from entries linked to people roster at show or episode level and stored in key . <itunes:author> and <podcast:person> tags are automatically derived from the people entries in show metadata. The option to delete all data of a show is located at the bottom of this page. https://offshore.pressed.press/WUI3/ WUI3 /WUI3/ Episode editor Episode editor can be launched from the “New episode” button on the top navigation, or when editing an existing episode. User can enter all metadata of an episode in this page. https://offshore.pressed.press/MD/ MD /MD/ Markdown shownotes reference https://commonmark.org/ offshore accepts commonmark markdown content for shownotes. It will be translated to proper HTML format on feed generation. HTML shownotes from external feed will be converted into markdown on import with markdownify. offshore supports the following list of markdown syntax. Syntax Format *Italic* or _Italic_ Italic **Bold** or __Bold__ Bold # Heading 1 or Heading 1 ## Heading 2 or Heading 2 or Hyperlink > Blockquote Blockquote ListListList OneTwoThree --- or *** `Inline code` with backticks Inline code with backticks Audio URL is checked for format and reachability on save. Episode artworks are also validated when newly set or changed. https://offshore.pressed.press/GUID/ GUID /GUID/ GUID Feature Globally unique identifiers (GUID) are unique identifiers for episodes. An episode’s GUID must remain unique and unchanged for it to be identified correctly. If an episode’s GUID is moodified in the feed, it will be recognized as a different episode. offshore generates uuidv5 GUIDs that fully compliant with the podcast namespace for each episodes created in offshore. This value is write-once and cannot be changed in anyway. For imported show, the GUID is inherited from the original feed and won’t be touched. All GUIDs are protected by <slug>.lock.json. https://offshore.pressed.press/WUI4/ WUI4 /WUI4/ Switch show https://offshore.pressed.press/FEATS/ FEATS /FEATS/ Core features https://offshore.pressed.press/CK/ CK /CK/ Check Feature https://offshore.pressed.press/CK2/ CK2 /CK2/ Check report https://offshore.pressed.press/FT3/ FT3 /FT3/ Image validation Feature Podcast and episode artworks are verified against Apple Podcast standards. Failing this check will produce notice to user, but won’t block feed generation. The automatic image validation is triggered in two occasions:when a new artwork url is added to a show, or an episode; or when a show or episode’s artwork url is changed. https://offshore.pressed.press/FT2/ FT2 /FT2/ <slug>.report.json Feature Check findings and audio probe results are stored in a separate <slug>.report.json file. This file will be automatically updated with checks representing the issues and things to improve in show metadata or assets. https://offshore.pressed.press/GEN/ GEN /GEN/ Feed generation Feature Based on the show metadata, offshore aim to generate podcast feed accurately and intelligently. offshore generates feed following RSS 2.0 specification, and incorporates Reference and Reference at the same time. offshore use markdown-it-py to translate markdown shownotes into HTML. The generated feed can be downloaded right away, or saved to a custom path configurable in the show settings. https://offshore.pressed.press/IMP/ IMP /IMP/ Importer feature https://offshore.pressed.press/PPL/ PPL /PPL/ People roster Feature A list of people entries to be included in episodes is maintained in show settings, and will automatically emit <podcast:person>, and <itunes:author> tags in proper locations on feed generation. https://offshore.pressed.press/PPL1/ PPL1 /PPL1/ Schema v2 › Universal people entries in show metadata Show and episode participants are now all selected from entries linked to people roster at show or episode level and stored in key . <itunes:author> and <podcast:person> tags are automatically derived from the people entries in show metadata. https://offshore.pressed.press/PY/ PY /PY/ A working Python 3.11+ installation Requirement offshore is written in Python and thus requires Python to run. offshore should generally be installed through the pip package manager. Guide for installing Python on your system is available here. https://offshore.pressed.press/INST/ INST /INST/ Install from PyPI pip install offshore-podcast Conventional podcast hosts like Fireside or Transistor work fine, but they can be expensive for small shows, and handing all your data to a single service is a real dependency. Self-hosted alternatives exist, but most are still designed as full-stack replacements that bundles frontend website, audio storage, and feed generation into one thing. A podcast feed is just a plain-text XML file. Hosting a handful of audio files and a text file is much easier, and cheaper than running a media server with a web frontend and database. And if you don’t want the website that comes with a podcast host then that part just becomes redundant. offshore aims to be a more basic solution. It simply helps you manages your show metadata locally and generates feed you can host wherever makes sense — a static site, an object storage, a CDN. Audio files and any other asset live wherever you want to host them. offshore ensures your metadata and assets comply with podcast standards, but otherwise stays out of the way. It can be used as a local feed generator, or reliably on a server to serve the feed directly. lechynte tianshi https://offshore.pressed.press/RN/ RN /RN/ Release notes tianshi 2026 7 18 https://offshore.pressed.press/RL0.5.2 RL0.5.2 /RL0.5.2 0.5.2 Release UI: Refine badges for simpler display; Refine the ignore button as single button with an one-time (per session) confirm dialogue; Reformat activity boxes as non-nested tables. Fixes: Fixes draft flag not working properly; Safer report saving when probing multiple assets; Fixes disabled asset check sometimes not respected. tianshi 2026 7 18 https://offshore.pressed.press/RL0.5.1 RL0.5.1 /RL0.5.1 0.5.1 Release Fixes: Draft flag not working properly; Disabled asset check not being respected in some occasion. Improvement: Safer report saving function when probing multiple assets. tianshi 2026 7 17 https://offshore.pressed.press/RL0.5.0 RL0.5.0 /RL0.5.0 0.5.0 Release Web UI: All new web UI built with Tailwind; feat: live asset preview. Fixes: Custom feed output path now handles filename correctly. Improvements: CLI can now pass optional fields; validate urls; implement category selection. tianshi 2026 7 15 https://offshore.pressed.press/RL0.4.2 RL0.4.2 /RL0.4.2 0.4.2 Release Fixes: custom path still output default filename podcast.xml. tianshi 2026 7 15 https://offshore.pressed.press/RL0.4.1 RL0.4.1 /RL0.4.1 0.4.1 Release Refactor CLI:Align fuctionality with web ui; Implement interactive sub menues for full show/episode editing ability; Allow passing text file to multi-line fields e.g. description and shownotes; Remove Typer border which can cause display issue on some system. Improvement:Improve code efficiency. tianshi 2026 7 14 https://offshore.pressed.press/RL0.4.0 RL0.4.0 /RL0.4.0 0.4.0 Release Function:Option to create draft episode; Options to disable asset probing completely; Option to auto inject year to tag ; Improvements:feature can now better detect alterd guid; Support decimal episode numbers. Fixes:Missing lock file won't throw guid mismatch error. tianshi 2026 7 13 https://offshore.pressed.press/RL0.3.1 RL0.3.1 /RL0.3.1 0.3.1 Release Core: Add back support for <itunes:owner> for compatibility via implementing of key . The same data will also emit tag . tianshi 2026 7 12 https://offshore.pressed.press/RL0.3.0 RL0.3.0 /RL0.3.0 0.3.0 Release https://offshore.pressed.press/SV2/ SV2 /SV2/ Schema v2 Schema v2 introduces new fields to the show metadata and centralizes check results into a separate report file. https://offshore.pressed.press/OBJ-SW2/ OBJ-SW2 /OBJ-SW2/ New show attributes key https://offshore.pressed.press/sw-output_path/ sw-output_path /sw-output_path/ output_path key An absolute path where the podcast feed file will be saved when generated. /shows/<slug>/podcast.xml by default. https://offshore.pressed.press/sw-owner/ sw-owner /sw-owner/ owner key Optional owner metadata for the show. Emits <itunes:owner> (contains <itunes:name> and <itunes:email>), and <podcast:locked>. Contains name, email, and locked boolean attributes. The name field also acts as a fallback for <copyright> if key is emptry. https://offshore.pressed.press/PPL1/ PPL1 /PPL1/ Schema v2 › Universal people entries in show metadata Show and episode participants are now all selected from entries linked to people roster at show or episode level and stored in key . <itunes:author> and <podcast:person> tags are automatically derived from the people entries in show metadata. https://offshore.pressed.press/OBJ-REP/ OBJ-REP /OBJ-REP/ Schema v2 › <slug>.report.json key Assets verification results will all be saved in the <slug>.report.json file, with only information useful to feed generation (e.g. audio duration, image size, or asset MIME type) will be write to the main show json file. This report.json contains separate chunks that log different information relavent to the assset checks: https://offshore.pressed.press/rep-check/ rep-check /rep-check/ check key The results of the most recent check run. https://offshore.pressed.press/ckc-checked_at/ ckc-checked_at /ckc-checked_at/ checked_at key The timestamp of the most recent check run. https://offshore.pressed.press/ckc-remote/ ckc-remote /ckc-remote/ remote key Boolean indicating if the check was run remotely or locally. https://offshore.pressed.press/ckc-findings/ ckc-findings /ckc-findings/ findings key An array of finding objects. See key . https://offshore.pressed.press/OBJ-FINDING/ OBJ-FINDING /OBJ-FINDING/ Finding key A single finding from a persisted check run. https://offshore.pressed.press/fnd-level/ fnd-level /fnd-level/ level key The severity level, either fail or note. https://offshore.pressed.press/fnd-where/ fnd-where /fnd-where/ where key A string indicating where the issue was found (e.g., episode GUID). https://offshore.pressed.press/fnd-domain/ fnd-domain /fnd-domain/ domain key The domain of the check: meta, image, or audio. https://offshore.pressed.press/fnd-code/ fnd-code /fnd-code/ code key A short error code string. https://offshore.pressed.press/fnd-message/ fnd-message /fnd-message/ message key A human-readable description of the finding. https://offshore.pressed.press/fnd-url/ fnd-url /fnd-url/ url key An optional URL related to the finding. https://offshore.pressed.press/rep-probe/ rep-probe /rep-probe/ probe key A dictionary keyed by episode guid containing audio probe results. https://offshore.pressed.press/prb-probed_at/ prb-probed_at /prb-probed_at/ probed_at key The timestamp when the probe was last run. https://offshore.pressed.press/prb-url/ prb-url /prb-url/ url key The URL of the probed audio file. https://offshore.pressed.press/prb-ok/ prb-ok /prb-ok/ ok key Boolean indicating if the probe succeeded. https://offshore.pressed.press/prb-method/ prb-method /prb-method/ method key The method used for probing: light (HEAD request) or full. https://offshore.pressed.press/prb-mime_type/ prb-mime_type /prb-mime_type/ mime_type key The content type returned by the probe. https://offshore.pressed.press/prb-length_bytes/ prb-length_bytes /prb-length_bytes/ length_bytes key The size of the audio file in bytes. https://offshore.pressed.press/prb-duration_seconds/ prb-duration_seconds /prb-duration_seconds/ duration_seconds key The duration of the audio in seconds. https://offshore.pressed.press/prb-error/ prb-error /prb-error/ error key An error message if ok is false. https://offshore.pressed.press/rep-show_image/ rep-show_image /rep-show_image/ show_image & image key Verification results for cover images. show_image contains the show cover result, and image is a dictionary keyed by episode guid. https://offshore.pressed.press/img-image/ img-image /img-image/ image key The status of the image check: ok, fail, unknown, or not_set. https://offshore.pressed.press/img-image_warnings/ img-image_warnings /img-image_warnings/ image_warnings key An array of warning strings from the image validation. https://offshore.pressed.press/img-url/ img-url /img-url/ url key The URL of the validated image. https://offshore.pressed.press/img-width/ img-width /img-width/ width key The width of the image in pixels. https://offshore.pressed.press/img-height/ img-height /img-height/ height key The height of the image in pixels. https://offshore.pressed.press/img-mime_type/ img-mime_type /img-mime_type/ mime_type key The MIME type of the image. https://offshore.pressed.press/rep-bypassed_urls/ rep-bypassed_urls /rep-bypassed_urls/ bypassed_urls key A list of URLs that have been manually bypassed for verification checks. https://offshore.pressed.press/SKIP/ SKIP /SKIP/ Bypassing Feature Using assets with issue may cause podcast not able to be played or displayed properly. This feature should be used with caution. User can choose to bypass all check on any asset that has issue. The bypass option will be visible on the check report alongside asset errors, and if persistent error found on repeated rechecks in episode specific error list. The bypass status is tied to asset url, stored in <slug>.report.json. The status will be automatically disabled if the asset url is changed. User can also manually disable the bypass flag by clicking on the “recheck” or “reprobe” button. https://offshore.pressed.press/TAG2/ TAG2 /TAG2/ <podcast:image> tag Part of podcast namespace. offshore will emit <podcast:image> tags on feed generation for show or episode level images. Defination of attributes of this tag can be found here. Improvement: People roster entries now can be created directly from episode or show editor. lechynte 2026 7 10 https://offshore.pressed.press/RL0.2.1 RL0.2.1 /RL0.2.1 0.2.1 Release Fixed: first-run setup should not consume piped stdin Detect when stdin is not a TTY via sys.stdin.isatty() and skip the interactive prompt, using the default shows_dir instead. This mirrors the existing OFFSHORE_SHOWS_DIR env-var guard. tianshi 2026 7 9 https://offshore.pressed.press/RL0.2.0 RL0.2.0 /RL0.2.0 0.2.0 Release https://offshore.pressed.press/FT1/ FT1 /FT1/ Set consistent feed output path per show Feature User can set a consistent output path of the feed XML file in per-show configuration. This enables serving the feed directly when using offshore on a server, or integrate it in other workflow. The path value is stored in key . On first feed generation of a show, the user will be prompted to confirm or change the default feed output path. It can be changed in show settings anytime. https://offshore.pressed.press/FT2/ FT2 /FT2/ <slug>.report.json Feature Check findings and audio probe results are stored in a separate <slug>.report.json file. This file will be automatically updated with checks representing the issues and things to improve in show metadata or assets. https://offshore.pressed.press/FT3/ FT3 /FT3/ Image validation Feature Podcast and episode artworks are verified against Apple Podcast standards. Failing this check will produce notice to user, but won’t block feed generation. The automatic image validation is triggered in two occasions:when a new artwork url is added to a show, or an episode; or when a show or episode’s artwork url is changed. Improvements: Adjust the fail/note level for several check items; Implement async checking backend to improve check speed; Refined UI, remove redundant buttons on dashboard (e.g. force generate, probe all) and only shown them when they’re useful. tianshi 2026 7 8 https://offshore.pressed.press/RL0.1.1 RL0.1.1 /RL0.1.1 0.1.1 Release Fixed: Probing for m4a files may have wrong result due to the metadata block put after data stream, this may also cause crash when saving an episode. Improvements: Removed redundant “description” field in episode form; <description> field in generated feed now derive from shownotes; Categories are now dropdowns. tianshi 2026 7 7 https://offshore.pressed.press/RL0.1.0 RL0.1.0 /RL0.1.0 0.1.0 Release Initiala release. Backlinks Related Contributions