How jerome-joseph-1/ulw-video-streaming-platform works
ULW is a Linux video platform with a media workflow and separate realtime services. The main media path is upload, queued transcode, HLS storage, then playback via rewritten playlists and presigned segment URLs. Chat routes room activity across owner nodes; live video has separate SFU and ingest-to-packager paths. The graph combines README-documented product relationships with sampled entry-point wiring; unsampled internals are represented at their existing directory paths, and no uncertain implementation links are asserted.
Main entry points: gateway/src Gateway · live-packager/src Live packager · postgres Catalog and jobs · s3 Object storage
Components 20
Video platform
- Gateway
apps/gateway/src - Transcode worker
apps/worker/src - Upload reaper
apps/reaper/src
Realtime services
- Chat server
apps/chat/src - Room router
rt/src/room_router.cpp - Room and message stores
infra/postgres/src
Live media
- STUNner
- LiveKit SFU
infra/sfu/livekit/src - SRT ingest
infra/srt/src/ingest.cpp - Live packager
apps/live-packager/src - Live remux
infra/ffmpeg/src/live_remux.cpp - Recording catalog
infra/postgres/src/live_recordings.cpp
Shared infrastructure
- Catalog and jobs
infra/postgres - Object storage
infra/storage/s3 - FFmpeg sandbox
infra/ffmpeg - Live HLS storage
infra/storage/s3/src/s3_transfer.cpp
Other components
- Client
- Envoy
- Chat client
- Call client
Connections 22
- Client → Envoy: sends requests
README.md - Envoy → Gateway: routes uploads
README.md - Gateway → Catalog and jobs: reads and writes
README.md - Gateway → Object storage: grants upload URLs
README.md - Transcode worker → Catalog and jobs: claims jobs
README.md - Transcode worker → FFmpeg sandbox: transcodes media
README.md - Transcode worker → Object storage: stores renditions
README.md - Gateway → Object storage: grants playback URLs
README.md - Gateway → Catalog and jobs: reads playback catalog
README.md - Upload reaper → Catalog and jobs: reaps abandoned uploads
README.md - Upload reaper → Object storage: cleans abandoned data
apps/reaper/src/main.cpp - Chat client → Envoy: connects
README.md - Envoy → Chat server: routes chat
README.md - Chat server → Room router: routes room activity
apps/chat/src/main.cpp - Chat server → Room and message stores: uses room and message stores
apps/chat/src/main.cpp - Room router → Room and message stores: persists room state
- Call client → STUNner: connects for calls
README.md - STUNner → LiveKit SFU: forwards media
README.md - SRT ingest → Live packager: feeds live stream
README.md - Live packager → Live remux: remuxes stream
apps/live-packager/src/main.cpp - Live packager → Live HLS storage: publishes HLS
README.md - Live packager → Recording catalog: records stream status
apps/live-packager/src/main.cpp