Broadcast & Streaming

Battle Trade does not host video. Hosts run their own streaming stack (OBS → Restream / Twitch / YouTube) and use Battle Trade for the on-screen overlays and the spectator experience.

Architecture

1. Host streams their webcam (and any contestant cameras) through OBS.
2. OBS adds Browser Sources pointed at our /overlay/[lobbyId]/* routes — these are HTML pages on a transparent background that render the live scoreboard, sponsor band, asset ticker, and prediction markets ticker.
3. OBS sends the composited feed to Restream / Twitch / YouTube.
4. Host pastes the public viewer URL into the lobby (via the broadcast admin panel). All /lobby/[id]/spectate, /wall, /cast surfaces embed it.

Overlay routes (OBS Browser Sources)

All overlays render on transparent background. Add as Browser Sources in OBS on top of the camera scene.

Spectator surfaces

For the audience watching on battle.fyi (not in OBS):

Setting the stream URL

1. Stream from OBS to Restream / Twitch / YouTube.
2. Copy the public viewer URL (e.g. youtube.com/watch?v=... or twitch.tv/yourchannel).
3. Open /lobby/[id]/broadcast?admin_pw=YOUR_PW.
4. Paste the URL into the “Stream Embed URL” field, click SET.
5. All spectator surfaces now embed the stream.

API Endpoints

GET /api/lobby/[id]/stream

Returns the stream embed URL set on the lobby.

PUT /api/lobby/[id]/stream

Set the stream embed URL (admin only).

// Request (requires admin auth)
{ "stream_url": "https://youtube.com/watch?v=..." }

// Response
{ "ok": true, "stream_url": "https://youtube.com/watch?v=..." }

OBS Setup (one-time)

1. In OBS, add a Browser source.
2. URL: https://battle.fyi/overlay/LOBBY_ID (or one of the per-component URLs above).
3. Width 1920, Height 1080 (or 3840×2160 for 4K).
4. Check “Refresh browser when scene becomes active”.
5. Drag the Browser source on top of your camera scene.
6. Stream from OBS to Restream / Twitch / YouTube as usual.

Kill Switches

NEXT_PUBLIC_BROADCAST_WALL_ENABLED=false   # Disables /lobby/[id]/wall
NEXT_PUBLIC_BROADCAST_CAST_ENABLED=false   # Disables /lobby/[id]/cast