How owncast/owncast works
Owncast is a self-hosted live-streaming and chat server. A broadcaster sends an RTMP stream to the backend, which ingests and transcodes it; viewers use the web interface to watch and chat. The repository also has distinct storage, federation, plugin, moderation, and monitoring capabilities. The README documents the product workflow, while the sampled entry point describes dependency wiring; unsampled implementation details and their connections are shown only where the README or source index supports them.
Main entry points: main.go Owncast server · server.go Live chat · rtmp RTMP ingest · service.go Stream lifecycle
Components 19
Runtime and ingest
- Owncast server
main.go - RTMP ingest
services/rtmp - Stream lifecycle
services/stream/service.go - Transcoder
services/transcoder/transcoder.go - Stream storage
services/storage
Viewer experience
- Web interface
web/components/layouts/Main/Main.tsx - Video player
web/components/video/OwncastPlayer/OwncastPlayer.tsx
Community features
- Live chat
services/chat/server.go - ActivityPub
services/activitypub - Webhooks
services/webhooks/webhooks.go
Platform services
- Plugins
services/plugins/manager.go - Database access
db/db.go - Authentication
auth/auth.go - Notifications
services/notifications/service.go
Administration
- Metrics
metrics/metrics.go - Admin interface
web/pages/admin/webhooks.tsx - Configuration
config/config.go
Other components
- Broadcaster
- Viewer
Connections 18
- Broadcaster → Owncast server: sends RTMP
README.md - Owncast server → RTMP ingest: accepts stream
main.go - RTMP ingest → Stream lifecycle: drives ingest
- Stream lifecycle → Transcoder: starts transcoding
- Transcoder → Stream storage: writes segments
- Viewer → Web interface: opens interface
README.md - Web interface → Video player: renders playback
web/components/layouts/Main/Main.tsx - Viewer → Live chat: joins chat
- Owncast server → Live chat: constructs service
main.go - Owncast server → ActivityPub: constructs service
main.go - Owncast server → Plugins: constructs service
main.go - Owncast server → Authentication: constructs service
main.go - Owncast server → Notifications: initializes service
main.go - Owncast server → Metrics: constructs service
main.go - Owncast server → Configuration: loads configuration
main.go - Owncast server → Database access: constructs repositories
main.go - Admin interface → Owncast server: updates settings
- Live chat → Webhooks: dispatches events
services/chat/server.go