How superstreamerapp/superstreamer works
Superstreamer is a self-hostable video-delivery platform: users submit processing work, produce packaged HLS media in object storage, then browse or play it; the platform also stitches dynamic playlists with interstitials and ads. The API, dashboard, artisan workers, stitcher, and player facade form the principal product areas. The README documents the processing, packaging, ad, and playback capabilities; sampled source confirms API route mounting and storage browsing/preview behavior. Unsampled worker and stitcher links are omitted where no direct wiring is evidenced.
Main entry points: storage.ts Storage endpoints · index.ts REST API · vast_client.js VAST client · pipeline.ts Media pipeline
Components 30
API and storage
- REST API
apps/api/src/index.ts - Job endpoints
apps/api/src/routes/jobs.ts - Asset endpoints
apps/api/src/routes/assets.ts - Storage endpoints
apps/api/src/routes/storage.ts - Storage schemas
apps/api/src/schemas/storage.ts - S3 access
apps/api/src/utils/s3.ts - Data repositories
apps/api/src/repositories - API workers
apps/api/src/workers/index.ts
Media processing
- Media pipeline
apps/artisan/src/workers/pipeline.ts - Transcoding
apps/artisan/src/workers/transcode.ts - HLS packaging
apps/artisan/src/workers/package.ts - Media object access
apps/artisan/src/lib/s3.ts
Playlist stitching
- Stitcher routes
apps/stitcher/src/routes/out.ts - Ad sessions
apps/stitcher/src/routes/sessions.ts - Playlist generation
apps/stitcher/src/playlist.ts - VMAP handling
apps/stitcher/src/vmap.ts - VAST handling
apps/stitcher/src/vast.ts
Operations dashboard
- Dashboard UI
apps/app/src/routes/(dashboard)/_layout/storage.tsx - API client
apps/app/src/api.tsx - File preview
apps/app/src/components/FilePreview.tsx
Playback and ads
- VAST client
extern/vast-client/src/vast_client.js - VAST parser
extern/vast-client/src/parser/vast_parser.js - Ad parsing
extern/vast-client/src/parser/ad_parser.js - VAST fetching
extern/vast-client/src/fetcher/fetcher.js - Client storage
extern/vast-client/src/util/storage.js - HLS player facade
packages/player/src/hls-player.ts - Event management
packages/player/src/event-manager.ts
Other components
- API user
- S3 media store
- Playback viewer
Connections 27
- API user → REST API: calls API
- REST API → Job endpoints: mounts routes
apps/api/src/index.ts - REST API → Asset endpoints: mounts routes
apps/api/src/index.ts - REST API → Storage endpoints: mounts routes
apps/api/src/index.ts - Storage endpoints → Storage schemas: validates responses
apps/api/src/routes/storage.ts - Storage endpoints → S3 access: reads objects
apps/api/src/routes/storage.ts - Dashboard UI → API client: requests storage
apps/app/src/routes/(dashboard)/_layout/storage.tsx - Dashboard UI → File preview: opens preview
apps/app/src/routes/(dashboard)/_layout/storage.tsx - File preview → API client: fetches file
apps/app/src/components/FilePreview.tsx - API client → Storage endpoints: calls storage API
apps/api/src/routes/storage.ts - Storage endpoints → S3 media store: lists and retrieves
apps/api/src/routes/storage.ts - Job endpoints → Data repositories: persists job data
- API workers → Media pipeline: dispatches work
- Media pipeline → Transcoding: transcodes media
- Media pipeline → HLS packaging: packages HLS
- HLS packaging → Media object access: writes outputs
- Media object access → S3 media store: writes media
- Stitcher routes → Playlist generation: serves playlists
- Ad sessions → VMAP handling: handles VMAP
- Ad sessions → VAST handling: schedules VAST
- VAST client → Client storage: stores state
extern/vast-client/src/vast_client.js - VAST client → VAST parser: parses responses
extern/vast-client/src/vast_client.js - VAST client → VAST fetching: fetches documents
extern/vast-client/src/vast_client.js - VAST parser → Ad parsing: parses ads
extern/vast-client/src/parser/vast_parser.js - Playback viewer → HLS player facade: uses player
- HLS player facade → Event management: manages events
packages/player/src/hls-player.ts - Playback viewer → Stitcher routes: requests stitched HLS