Mimir/docs/self-hosted-live-edge.md
2026-06-01 01:56:19 +01:00

127 lines
4.6 KiB
Markdown

# Self-Hosted Live Edge
Mimir's self-hosted broadcast path keeps OBS optional. Starfire owns the final
program frame and audio mix; Yggdrasil owns public byte distribution.
```mermaid
flowchart LR
A["Fensalir program texture"] --> B["Starfire NVENC encode"]
C["Faust/Mimir mix"] --> B
B --> D["SSH TCP forward"]
D --> E["Yggdrasil localhost RTMP ingest"]
E --> F["HLS segment ring"]
F --> G["streampixels.gamecult.org static HTTPS"]
G --> H["gamecult.org/livestream static viewer"]
```
## Authority Map
- Owner: `Mimir.Broadcast` owns the Starfire-side encoded push command.
- Inputs: final program media, FFmpeg/NVENC capability, and the SSH-forwarded
RTMP endpoint.
- Outputs: one CBR H.264/AAC RTMP stream to Yggdrasil.
- Derived state: Yggdrasil's HLS playlist and segments are derived from that
encoded stream. They do not own composition, timing, or transcoding.
- Forbidden writers: Yggdrasil must not transcode the program stream in the
first live edge. OBS is not the primary broadcast owner.
- Shared paths: synthetic smokes and real program pushes use the same RTMP URL:
`rtmp://127.0.0.1:11935/live/mimir`.
- Deletion line: if a later CDN or WebRTC edge appears, keep this path as the
simple origin proof or delete it. Do not keep two public stream authorities.
## First Smoke
On Starfire, with an SSH local forward active to Yggdrasil's localhost RTMP
port:
```powershell
dotnet run --project .\src\Mimir.Broadcast\Mimir.Broadcast.csproj -- --smoke
dotnet run --project .\src\Mimir.Broadcast\Mimir.Broadcast.csproj -- --print-command
```
The default push target is:
```text
rtmp://127.0.0.1:11935/live/mimir
```
The public HLS playlist is served on the existing Yggdrasil-routed
StreamPixels domain:
```text
https://streampixels.gamecult.org/mimir/live/hls/mimir.m3u8
```
The static viewer lives on the root GameCult site:
```text
https://gamecult.org/livestream
```
## Local Recording Before Public Push
Before pushing a live program to Yggdrasil, record the same simple stream-proof
shape locally and judge sync from the artifact:
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\record-stream-proof-output.ps1 -StartRavenSender -DurationSeconds 20
```
The recording harness listens for a Raven muxed A/V SRT feed on a private test
port, overlays Kiyo Pro as picture-in-picture, mixes Raven Realtek loopback with
Starfire's Scarlett capture, applies conservative FFmpeg denoise filters, and
writes an MP4 under `artifacts\runtime\stream-proof\`.
The current routing contract is explicit:
- Starfire Realtek/default render is the chirp/speaker emission lane.
- Raven Realtek/default render loopback is the co-streamer game/program lane.
It is packaged with Raven's NVENC video feed back to Starfire.
- Starfire Scarlett carries the hero mic capture and monitored local mix for
judgment. Raven's Scarlett is only routing the remote shotgun into Starfire
Scarlett, currently on channel 1.
- The proof recording is allowed to mix those lanes for human sync judgment, but
it must not collapse their authority. Starfire Realtek proves chirp emission,
Raven Realtek proves the co-streamer/game program path, and Scarlett proves
the hero mic/shotgun capture path.
This is a bridge recording, not public broadcast truth. It exists so humans can
judge audio/video sync and tell Mimir which offsets to apply before the RTMP/HLS
edge is involved. Offset knobs are explicit:
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\record-stream-proof-output.ps1 `
-StartRavenSender `
-RavenOffsetSeconds 0.000 `
-KiyoOffsetSeconds 0.000 `
-MicOffsetSeconds 0.000
```
If Windows firewall blocks direct SRT/UDP during a local proof, run the Raven
leg through an SSH TCP tunnel instead:
```powershell
Start-Process ssh.exe -ArgumentList '-o ExitOnForwardFailure=yes -N -L 6204:127.0.0.1:5204 -l "madman''s lullaby" 192.168.1.84' -WindowStyle Hidden
powershell -ExecutionPolicy Bypass -File .\scripts\record-stream-proof-output.ps1 `
-StartRavenSender `
-RavenSenderListens `
-RavenSenderTransport tcp-listener `
-RavenInputOverride tcp://127.0.0.1:6204
```
That fallback keeps the proof private to the LAN/SSH path and avoids changing
machine firewall policy just to capture a judging artifact.
## Scaling Rule
Viewer capacity is approximately:
```text
available Yggdrasil egress / encoded bitrate
```
Micro-optimizations count only when they improve target-host measurements:
served Mbps, p95 segment latency, CPU, memory, syscalls, or stall rate on
Yggdrasil. The first edge uses nginx static serving and kernel file paths so
the hot path is byte distribution, not application code.