Retroverse · Classic NES Tetris
NestrisLTM
Local Tournament Manager¶
From the NES on the table to the scoreboard on the wall. NestrisLTM reads every game straight off the console's video signal. It knows who is playing from their RFID player card, and puts live scores, versus overlays and brackets on screen. It needs no manual score entry and no cloud.
Beta · work in progress
The NestrisLTM suite is in beta and under active development. It is already used at Retroverse, but features, interfaces and this documentation may still change between releases. Some parts are marked as Preview or Planned. Feedback and bug reports are welcome on GitHub.
What is it?¶
NestrisLTM is the software suite behind the Classic NES Tetris tournament at Retroverse, a retro gaming event in Wattens, Tyrol. It turns a room full of NES consoles into a fully tracked tournament:
- Capture stations watch each console through a USB capture stick and recognise score, lines, level, the next piece and the whole playfield in real time.
- RFID player cards say who is playing. A player taps their card and the station attributes the game to them.
- The host app collects every game in a database. It runs the highscore and the bracket, and it serves broadcast-ready OBS overlays and full-screen displays.
- A touch terminal lets players register, get their card, look at their stats and watch replays of their own games.
The four building blocks¶
-
NestrisLTM
The host application: database, admin UI, highscore, bracket, OBS scenes and update manager. It is a Windows tray app.
-
nestris-core
A high-performance Rust recognition engine. It also contains nestris-station, the headless capture daemon for every console, plus desktop and web tools.
-
nestris-terminal
The touchscreen kiosk where players register, receive their card, check their rank and watch replays.
-
nestris-rfid-reader
ESP32 firmware for the self-built card reader: RC522 RFID and an OLED display, speaking JSON over USB serial.
How it fits together¶
flowchart LR
NES["<span style='color:#f8fafc'>🎮 NES console</span>"]:::hw --> ST
CARD["<span style='color:#f8fafc'>💳 Player card</span>"]:::hw -. tap .-> RD1
RD1["<span style='color:#111111'>RFID reader</span>"]:::rfid -- USB --> ST
ST["<span style='color:#111111'>nestris-station<br/><small>nestris-core</small></span>"]:::core -- "MQTT · live + results" --> LTM
ST -- "HTTP · game recording" --> LTM
LTM["<span style='color:#111111'>NestrisLTM<br/><small>host app + PostgreSQL</small></span>"]:::ltm -- "WebSocket" --> OUT
OUT["<span style='color:#ffffff'>📺 Overlays · highscore · bracket</span>"]:::ext
TERM["<span style='color:#111111'>nestris-terminal<br/><small>touch kiosk</small></span>"]:::term -- "REST" --> LTM
RD2["<span style='color:#111111'>RFID reader</span>"]:::rfid -- USB --> TERM
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef rfid fill:#f472b6,stroke:#be185d,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
NestrisLTM nestris-core nestris-terminal nestris-rfid-reader outputs / third-party
All diagrams on this site use these colours for the same components. Continue with the system overview, or go straight to the event setup guide.
Highlights¶
-
Reads the console itself
It uses classical computer vision with no machine learning. It calibrates itself, tracks the playfield through camera drift, and gives the same results as the original Python engine, checked by golden tests.
-
Fair play built in
It detects the Select score trick (+10 000), validates every game and keeps a frame-perfect recording of each one as evidence.
-
Never loses a result
Results are written to an on-disk spool first. MQTT sessions are persistent, delivery is at least once and duplicates are removed. A station or network outage doesn't lose games.
-
Broadcast-ready
It comes with 1080p transparent OBS overlays: single, 1v1, double 1v1, 4-player, replay. They include live diff graphs, a "needs N tetrises" counter and NES-accurate playfields.
-
Tournament tools
Highscore qualification per event, a single-elimination bracket for 2–64 players, rounds that freeze finished scores, and remote control from Stream Deck.
-
Signed updates
Releases are built by GitHub Actions and signed with Ed25519. The host app checks for updates, makes a backup and installs with one click.