51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
# 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
|
|
|
|
```sh
|
|
# 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
|
|
|
|
```sh
|
|
go run .
|
|
# or
|
|
CGO_ENABLED=0 go build -o podstalk . && ./podstalk
|
|
```
|