Skip to content

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.

Get started Downloads GitHub

Animated NES Tetris playfield

60 Hzlive playfield and score per station
~3 msrecognition time per video frame
0 typingscores are read from the screen and counted automatically
100 %offline: everything runs on the event LAN

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.

    Learn more · Release

  • 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.

    Learn more · Release

  • nestris-terminal


    The touchscreen kiosk where players register, receive their card, check their rank and watch replays.

    Learn more · Release

  • nestris-rfid-reader


    ESP32 firmware for the self-built card reader: RC522 RFID and an OLED display, speaking JSON over USB serial.

    Learn more · Release

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.