Streaming & OBS¶
NestrisLTM renders every overlay in the browser. Add it to OBS as a Browser Source at 1920×1080. The background is transparent, so you can put the overlay over your own camera feeds, artwork or the raw console video.
flowchart LR
ST1["<span style='color:#111111'>Station 1</span>"]:::core & ST2["<span style='color:#111111'>Station 2</span>"]:::core -- "live 60 Hz" --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
LTM -- "WebSocket /ws/scene/{slug}" --> BS["<span style='color:#ffffff'>OBS Browser Source<br/>/o/{slug}</span>"]:::ext
CAM["<span style='color:#f8fafc'>Cameras · console video</span>"]:::hw --> OBS["<span style='color:#ffffff'>OBS scene</span>"]:::ext
BS --> OBS --> OUT["<span style='color:#ffffff'>📡 Stream / projector</span>"]:::ext
DECK["<span style='color:#ffffff'>Stream Deck</span>"]:::ext -- "POST /api/scenes/{slug}/rounds" --> LTM
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3
Scenes¶
A scene has a fixed URL /o/<slug>, a layout and one station per slot. You change which stations feed a scene in the admin UI (Szenen), and OBS never needs to be touched during the event.
| Layout | Slots | Typical use |
|---|---|---|
single |
1 | Feature one player with the full playfield and statistics |
single_compact |
1 | Smaller single-player box for a corner of the screen |
1v1 |
2 | Bracket match: two players head to head |
2x1v1 |
4 | Two matches side by side |
4p |
4 | Four-player heat (see modes below) |
replay |
1 | Play back a recorded game on stream |
4-player modes¶
| Mode | Who advances |
|---|---|
none |
Nobody: a show match without outcome stamps |
top2_advance |
The best two advance (WEITER), the others are out (RAUS) |
worst_out |
Everyone except the lowest score advances |
winner_only |
Only the best wins (SIEGER) |
An outcome is stamped as soon as it is certain, not only when every game has ended. For example, a finished player is marked as advancing once too few players can still overtake them.
What the overlay shows¶
- NES-accurate playfields at 60 Hz in the original level colours, including the falling piece.
- Score, lines, level, next piece, tetris rate, burn and drought. A drought of 13 or more pieces blinks.
- A tetris flashes the board, just like on the console.
- Versus figures calculated on the server:
- score difference and a live difference graph
- lead in tetrises: lead ÷ (1200 × (level + 1)) of the trailing player
- pace projected to level 29
- "needs N tetrises" for the trailing player
- Outcome stamps (WEITER / RAUS / SIEGER) when a round is decided.
Rounds¶
stateDiagram-v2
direction LR
[*] --> Waiting
Waiting --> Playing: game starts on slot
Playing --> Frozen: game ends → result frozen
Frozen --> Frozen: further games on this slot ignored
Frozen --> Waiting: Neue Runde / Auto-Runde / Stream Deck
Frozen --> Waiting: Slot zurücksetzen (single slot)
The result of a slot freezes when its game ends, so a player who starts a new game by mistake doesn't overwrite the result. The crew starts the next round with a click, automatically, or with a Stream Deck button. The button calls POST /api/scenes/{slug}/rounds with a token of scope scenes.
Highscore display on stream¶
The full-screen highscore and bracket display can also be used in OBS:
http://<host>:7990/view/highscore?transparent=1
http://<host>:7990/view/highscore?only=bracket&transparent=1
The tournament console controls it remotely: font size, autoscroll, effects, banners, transparency and the champion celebration.
OBS tips¶
- Set the browser source to 1920×1080 and enable Shutdown source when not visible only if you don't mind a short reconnect when switching scenes.
- Use a cable connection for the stream PC. Every overlay keeps a WebSocket open to the host.
- Test every scene with
nestris-ltm simulate. It replays NGF recordings as simulated stations, so you can rehearse without consoles.