Skip to content

Components

The suite consists of four repositories. Each has its own release cycle, CI pipeline and signed release artifacts.

  • NestrisLTM


    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

  • nestris-core


    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

  • nestris-terminal


    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

  • nestris-rfid-reader


    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