Skip to content

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.