Owncast
Self-hosted single-streamer live video and chat server with an admin REST API.
A Go server that accepts RTMP from OBS or any encoder, serves an HLS player with chat, and federates to the Fediverse. Everything the admin panel does is an HTTP endpoint documented in the repo's openapi.yaml, so an agent can retitle the stream, moderate chat, rotate stream keys, and read viewer stats.
- I want to stream to my own domain instead of Twitch and have my agent retitle the stream and moderate chat
- I run community events and need a private RTMP endpoint with chat I control
- Admin API uses HTTP basic auth with the admin password; issue Access Tokens for integrations instead of sharing it
- No Windows server support; use WSL2
- Configuration lives in the SQLite database and admin panel, not in a config file, so infrastructure-as-code means scripting the API
Last activity Sep 3, 2026. Fit: adaptable 0, operable 3.
Operable: what an agent can drive
Interface
OfficialAPIpublished by the builderlocal
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 9 of 10 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Set stream title, name, summary, tags, and page content | Reachable | openapi.yaml: /admin/config/streamtitle, /admin/config/name, /admin/config/serversummary, /admin/config/tags, /admin/config/pagecontent |
| Manage stream keys and RTMP/web ports | Reachable | openapi.yaml: /admin/config/streamkeys, /admin/config/rtmpserverport, /admin/config/webserverport |
| Configure video output variants, codec, and latency | Reachable | openapi.yaml: /admin/config/video/streamoutputvariants, /admin/config/video/codec, /admin/config/video/streamlatencylevel |
| Moderate chat: hide messages, ban IPs, set moderators | Reachable | openapi.yaml: /admin/chat/messagevisibility, /admin/chat/users/ipbans/create, /admin/chat/users/setmoderator |
| Read live status, viewer counts, and hardware stats | Reachable | openapi.yaml: /admin/status, /admin/viewers, /admin/viewersOverTime, /admin/hardwarestats |
| Manage Fediverse followers | Reachable | openapi.yaml: /admin/followers, /admin/followers/approve, /admin/followers/remove, /admin/followers/blocked |
| Disconnect the inbound broadcast | Reachable | openapi.yaml: /admin/disconnect |
| Start broadcasting | Not reachable | Owncast only ingests RTMP; starting a stream is the encoder's job (OBS, ffmpeg), not an API call |
| Send chat messages as an integration | Reachable | docs Integrations section: Access Tokens and External Actions; public /chat endpoints in openapi.yaml |
| Configure S3 storage and external CDN | Reachable | openapi.yaml: /admin/config/s3, /admin/config/videoservingendpoint |
Code stack
- Languages
- GoTypeScript
- Frameworks
- React
- Package manager
- npm
- Database
- SQLite
- Hosting target
- Linux serverDocker
- Built
- Human-written (recorded, never ranked)
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README: Go backend plus React web frontend served on :8080 | 95% |
| executionModel | no model at runtime; ffmpeg transcoding only | 99% |
| operability | openapi.yaml at repo root and owncast.online/api published by the Owncast project | 95% |
| effort | no env var, config file, or prompt file documented; runtime flags only (owncast.online/docs/configuration/runtime-flags) | 0% |
| editions | MIT LICENSE; free downloads and Docker image | 95% |
| active | GitHub pushedAt 2026-09-03; release v0.2.5 2026-04-11 | – |
| reach | 85% |
Open questions
- Owncast has no documented env var or config file; only runtime flags (--database, --webserverport, --rtmpport, --adminpassword). If the Curator accepts flags as a surface, add Adaptable at fork-and-modify with fit 1
- Confirm webhook endpoints (/admin/webhooks/*) in the current openapi.yaml; the first 80 paths listed did not reach them
Sources
- owncast.online sourcing:video-streaming:community
- github.com/owncast/owncast sourcing:video-streaming:community
- owncast.online/docs/configuration/runtime-flags/ analysis