========================================================================
                 GRIDMETRICS — TELEMETRY RECORDER CLIENT
========================================================================

Ciao pilota! Questo piccolo programma registra la telemetria delle tue sessioni
su F1 25 e F1 26 e la carica sulla piattaforma web di GridMetrics, dove analizzi
giri, telemetria comparata, usura gomme e assetto.

------------------------------------------------------------------------
LA COSA PIU' IMPORTANTE DA SAPERE
------------------------------------------------------------------------
* IL GIOCO PUO' ESSERE DOVE VUOI: PC, PlayStation 5 o Xbox.
* GRIDMETRICS RECORDER GIRA SU UN COMPUTER COLLEGATO ALLA STESSA RETE:
  Windows, macOS o Linux. NON serve un PC potente: anche un portatile vecchio
  va benissimo (l'antenna usa meno dell'1% di un core e non perde pacchetti).
* I grafici si guardano da qualsiasi dispositivo: PC, Mac, tablet, telefono.

------------------------------------------------------------------------
COME SI USA (Windows)
------------------------------------------------------------------------
1. Assicurati di avere Node.js 18 o superiore: https://nodejs.org
2. Apri lo ZIP e fai doppio clic su: CLICCA_QUI_PER_INSTALLARE.bat
   (crea l'icona GridMetrics sul Desktop e l'avvio automatico con Windows)
3. La prima volta crea da sola la regola firewall per la telemetria da console.
4. Per archiviare le sessioni nel TUO account: apri la Web App sullo stesso
   computer e premi "Collega al mio account" (un clic, nessun codice).

------------------------------------------------------------------------
COME SI USA (macOS)
------------------------------------------------------------------------
1. Installa Node.js 18+: https://nodejs.org
2. Apri il file .tar.gz e fai doppio clic su: INSTALLA_SU_MAC.command
   (se macOS lo blocca: clic destro -> Apri -> Apri; oppure nel Terminale:
    chmod +x INSTALLA_SU_MAC.command && ./INSTALLA_SU_MAC.command)
3. Copia l'antenna in ~/Library/Application Support/GridMetrics e attiva
   l'avvio automatico al login.

------------------------------------------------------------------------
COME SI USA (Linux / Steam Deck desktop mode)
------------------------------------------------------------------------
1. Installa Node.js 18+ (apt/dnf/pacman install nodejs npm)
2. Estrai l'archivio ed esegui: bash installa_su_linux.sh
   (copia l'antenna in ~/.local/share/GridMetrics e crea l'avvio automatico)

------------------------------------------------------------------------
RIPETITORE UDP: volante, dashboard e software di terzi
------------------------------------------------------------------------
Il gioco invia la telemetria a UNA sola destinazione. Se usi anche un volante,
una dashboard o un software come SimHub, apri il pannello della Web App
(icona con le porte UDP) e aggiungi le USCITE del ripetitore: l'antenna riceve
una volta e rimette una COPIA IDENTICA su ogni uscita (es. 127.0.0.1:20778 per
un software su questo PC, 192.168.1.50:20779 per la dashboard su tablet).
L'app di terzi va impostata su una porta DIVERSA da quella di ingresso.

------------------------------------------------------------------------
NON PERDERE NULLA
------------------------------------------------------------------------
* Ogni stint viene archiviato e sincronizzato appena entri in corsia box:
  non devi aspettare la fine della sessione per vedere i dati.
* Senza account collegato le sessioni restano al sicuro in locale e
  nell'archivio condiviso: nessun dato va perso.
========================================================================
