U-Pod

Overview

This is U-Pod, the torpedo-style podcast system with minimal footprint and maximum utility.

No databases needed to function, no cloud required, no datacenter necessary - just the filesystem and your content. Even your mom on her knees could help set it up, though that's not a functional requirement.

Setup

First, you need to build the image. I've included a handy Dockerfile in the folder. Use it.

Once you've created your image, use Docker to run it after setting these environment variables. By example, for my one:

      PODCAST_PORT: ":8000" 
      PODCAST_BASE_URL: "https://bbs.keinpfusch.net" 
      PODCAST_AUDIO_DIR: "/app/audio" 
      PODCAST_COVERS_DIR: "/app/covers" 
      PODCAST_TITLE: "Das Böse Büro"
      PODCAST_AUTHOR: "Uriel Fanelli"
      PODCAST_COPYRIGHT: " Ⓒ2025 Uriel Fanelli"
      PODCAST_LOGO: "https://bbs.keinpfusch.net/cover.jpg"
      PODCAST_DESCRIPTION: "Il Podcast della Frangia Lunatica"
      PODCAST_LANGUAGE: "it-IT"

File Linking

What links files in /audio to files in /covers?

Files must share the same name, for example:

/audio/yourmom.mp3

must correspond to:

/covers/yourmom.jpg

It's simple. You don't need a fucking RDBMS for this. The filesystem is enough.

U-Pod will then create the torpedo, with the image properly linked to the audio.

Once you have the Docker image, simply create the /data folder and put your files in it.

Podcast Player Badge - nice to know

/badge/EPISODE_NAME (the episode name without .mp3) generates a standalone HTML5 audio player. Embed it anywhere with