Components¶
The suite consists of four repositories. Each has its own release cycle, CI pipeline and signed release artifacts.
-
Local Tournament Manager, the host application. It ingests the stations over MQTT and stores everything in PostgreSQL. It serves the admin UI, OBS overlays, the highscore and bracket display, and the terminal API. Windows tray app with an installer and signed one-click updates.
Beta · Repository · Latest release
-
Recognition engine in Rust plus nestris-station, the Debian capture daemon for each console. Also includes a CLI, egui and Qt desktop GUIs, a WebAssembly browser GUI, and the NGF recorder and replay engine.
Beta · Repository · Latest release
-
Retroverse Terminal, the touch kiosk for players. Players register, get their card written, see their stats and rank, and replay their games. A client of NestrisLTM with no database access of its own.
Beta · Repository · Latest release
-
Card reader firmware for ESP32 + RC522 + SSD1306. It reports cards instantly, shows the host's text on the OLED and writes cards safely. JSON protocol v2 over USB serial.
Preview · Repository · Latest release
Who talks to whom¶
flowchart LR
RD["<span style='color:#111111'>nestris-rfid-reader</span>"]:::rfid -- "serial JSON v2" --> ST["<span style='color:#111111'>nestris-core<br/>(nestris-station)</span>"]:::core
RD -- "serial JSON v2" --> TERM["<span style='color:#111111'>nestris-terminal</span>"]:::term
ST -- "MQTT + HTTP upload" --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
TERM -- "REST" --> LTM
LTM -- "MQTT cmd (show on reader)" --> ST
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
Lineage¶
The suite grew out of several earlier tools, and each generation replaced the last:
timeline
title From prototypes to the current suite
Upstream : NESTrisOCR (third-party OCR) : NestrisChamps (NGF format)
Generation 1 : NestrisLTM desktop app with embedded OCR : TournamentHigscore kiosk : RetroverseAnmeldung touch registration
Generation 2 : NestrisLTM_OCR — standalone Python engine (JSON schema v4)
Current : nestris-core — Rust port, verified against the Python engine : NestrisLTM — new host app : nestris-terminal : nestris-rfid-reader protocol v2