podstalk/README.md

Podstalk

Podstalk is a bare-bones podcast hosting platform. It hosts a single podcast — allowing a user to create and manage episodes and serve an RSS feed for subscribers.

Quick Start

# Build the image
docker build -t podstalk .

# Run with persistent storage and your podcast's public URL
docker run -d \
  --name podstalk \
  -p 8080:8080 \
  -v podstalk-data:/data \
  -v podstalk-uploads:/uploads \
  -e PODSTALK_LINK=https://podcast.example.com \
  -e PODSTALK_TITLE="My Podcast" \
  podstalk

On first launch, visit http://localhost:8080/signup to create your account.

Environment Variables

Variable	Default	Description
PORT	8080	HTTP listen port
PODSTALK_DB	podstalk.db	SQLite database path
PODSTALK_UPLOAD_DIR	uploads	Audio/image file storage
PODSTALK_LINK	http://localhost:8080	Public URL (used in RSS feed)
PODSTALK_TITLE	Podstalk	Fallback podcast title
PODSTALK_AUTHOR	Podstalk	RSS author field

The podcast title and image can also be set from the dashboard after signing in.

RSS Feed

The RSS 2.0 feed (with iTunes extensions) is available at /rss. It includes <enclosure>, <itunes:image>, <guid>, and <pubDate> for each episode.

Running Without Docker

go run .
# or
CGO_ENABLED=0 go build -o podstalk . && ./podstalk