SPRAG - Programma per Windows 11 (prova personale)
==================================================

Sprag ti fa usare l'iPhone come mouse, tastiera e telecomando per questo PC,
tramite la rete Wi-Fi di casa. Questa e' una versione di prova.

1. COME AVVIARLO
   - Estrai la cartella "Sprag" dallo zip (clic destro > Estrai tutto).
   - Metti la cartella Sprag in un posto fisso (per esempio Documenti\Sprag) PRIMA del primo avvio, e negli
     aggiornamenti estrai il nuovo zip sopra la stessa cartella: cosi' "Avvia con Windows" non perde il percorso.
   - Fai doppio clic su Sprag.exe. Non serve installare nulla.
   - Se compare la schermata blu "Windows ha protetto il PC":
       clic su "Ulteriori informazioni", poi su "Esegui comunque".
     (Succede perche' il programma non e' ancora firmato: e' normale per questa prova. Se in inglese:
     "More info" > "Run anyway".)

1b. AGGIORNAMENTI
   - Sprag si aggiorna da solo. Due minuti dopo l'avvio e poi ogni 6 ore cerca una nuova versione su
     www.antonio.ai/sprag, la scarica, controlla che sia davvero nostra (firma digitale, dimensione e impronta) e la
     installa quando nessun telefono e' collegato e nessun gioco e' in corso. Sprag si chiude per qualche secondo e si
     riapre da solo; impostazioni e telefoni abbinati restano. Poi un avviso dice "Sprag e' aggiornato alla 0.1.x" con
     le novita'.
   - Menu dell'icona: "Cerca aggiornamenti" (subito) e "Aggiorna automaticamente" (acceso di default; anche in
     Impostazioni > Connessione). Se lo spegni, Sprag ti dice solo che c'e' una versione nuova e la installa se premi "Aggiorna".
   - Se un telefono e' collegato Sprag aspetta, oppure premi "Riavvia per aggiornare" nell'avviso. Durante una partita
     aspetta sempre.
   - Se la cartella di Sprag non e' scrivibile (per esempio in C:\Programmi) o un aggiornamento non riesce, Sprag lo dice
     e "Scarica" apre il sito: estrai a mano il nuovo zip sopra la stessa cartella.

2. FIREWALL
   - Al primo avvio Windows chiede se consentire Sprag sulla rete (la finestra di Sprag resta aperta anche se
     la richiesta le toglie il focus: non serve riaprirla).
     Spunta "Reti private" e premi "Consenti accesso" ("Private networks" > "Allow access" in inglese).
     Se non compare la richiesta o hai premuto Annulla, vai in
     Impostazioni > Privacy e sicurezza > Sicurezza di Windows > Firewall e protezione rete >
     "Consenti app attraverso il firewall" e abilita Sprag per le reti private.
   - L'iPhone e il PC devono essere sulla stessa rete Wi-Fi (non rete "ospiti").

3. COME ABBINARE L'IPHONE
   - Al primo avvio la finestrella di Sprag si apre da sola e resta aperta finche' non la chiudi (pulsante X in alto
     a destra o tasto Esc) o finche' non hai abbinato il primo telefono. Una notifica ti dice dove sta l'icona.
   - ATTENZIONE: Windows 11 mette le icone nuove NASCOSTE sotto la freccia "^" accanto all'orologio. Se non vedi
     l'icona di Sprag, clicca la freccia "^": la trovi li'. Per averla sempre in vista trascinala fuori dalla freccia
     (oppure Impostazioni > Personalizzazione > Barra delle applicazioni > Altre icone della barra delle applicazioni).
   - La finestrella mostra un codice QR e un codice di 16 caratteri
     (es. 7KQF-3M9D-X2HB-PW4R). Il QR cambia ogni 30 secondi ed e' nascosto a condivisioni dello schermo e screenshot
     (se condividi lo schermo, la finestrella appare vuota agli altri). Il codice scritto si rinnova ogni 2 minuti.
     La finestrella deve restare aperta: se la chiudi, nulla si abbina.
   - Sull'iPhone apri l'app Sprag e scegli UNA di queste strade:
       a) "Scansiona il codice QR" e inquadra il QR sullo schermo del PC: BASTA, sul PC non devi premere niente.
          Il PC mostra per 15 secondi "Abbinato a <iPhone>" con "Non sei tu? Rimuovi" (il telefono resta anche
          nell'elenco dei telefoni abbinati). Con il QR non c'e' il numero di conferma qui sotto;
       b) tocca il tuo PC nell'elenco "PC vicini" e scrivi il codice;
       c) "Inserisci il codice a mano" con l'indirizzo che vedi nella finestra
          (es. 192.168.1.20:47800) e il codice.
   - NUMERO DI CONFERMA (solo se scrivi il codice a mano, strade b e c): subito dopo, PC e iPhone mostrano le stesse 6 cifre (es. 482 913).
     Se sono uguali premi "Si, coincide" sul telefono E INVIO sulla tastiera del PC (non serve il mouse). Se sono diverse premi Esc:
     qualcuno potrebbe essere in mezzo. L'abbinamento si completa solo quando hai confermato su entrambi.
     Se Windows non porta la finestra davanti, il tasto Invio non arriva: tasto Windows + B, frecce fino all'icona di Sprag,
     MAIUSC + F10 > "Rispondi alla richiesta di abbinamento".
     Puoi cambiare app sull'iPhone mentre aspetti: se la connessione cade, Sprag riprende da solo entro 2 minuti, senza nuova scansione.
   - Dopo l'abbinamento l'iPhone si ricollega da solo, senza codice.
   - Per togliere un telefono: icona vicino all'orologio > Impostazioni > Telefoni abbinati > menu del telefono > "Rimuovi questo telefono"
     (una finestra scura chiede conferma con i pulsanti "Rimuovi" e "Annulla").

3b. IMPOSTAZIONI (icona vicino all'orologio > Impostazioni, oppure l'ingranaggio nella finestrella)
   - In alto tre profili: "Giochi dal divano", "Presentazione", "Blindato". Cambiare qualunque interruttore li rende "Personalizzato".
   - Per ogni telefono scegli l'accesso: "Solo telecomando" (puntatore, tasti, media, slide) oppure "Controllo completo"
     (aggiunge: finestre e app, appunti, blocca/sospendi, riavvia/arresta, aprire app e link).
   - "Chiedi prima": Apri app e link, Azioni dell'IA, Condividi questo schermo. Restano spenti finche' non li consenti
     (oppure finche' non rispondi "Consenti" alla richiesta che il PC mostra quando il telefono la fa).
   - "Sblocca le app bloccate" (acceso di default in "Giochi dal divano"): se un gioco o un programma si blocca, dal telefono
     (scheda Finestre, tasto "Sblocca" nei Collegamenti, oppure a voce) tocchi "Chiudi": Sprag chiede prima con garbo di chiudersi
     e aspetta 3 secondi; solo se resta bloccato e confermi "Forza la chiusura" lo termina (con i suoi processi figli, mai il launcher).
     Non tocca mai processi di Windows, antivirus e Sprag stesso; Esplora risorse solo con "Riavvia Esplora risorse".
     Giochi con anti-cheat o avviati come amministratore: Windows puo' rifiutare, il telefono propone Gestione attivita'.
     Ogni azione e' scritta in %LOCALAPPDATA%\Sprag\audit.log.
   - Riavvia/Arresta partono dopo 30 secondi: sul PC compare un avviso con "Annulla" (si puo' annullare anche dal telefono).

3c. RISPONDERE ALLE RICHIESTE DI WINDOWS (UAC) DAL TELEFONO
   - Sprag te lo propone da solo con UNA finestra, appena e' utile (dopo aver abbinato l'iPhone, oppure la prima volta
     che Windows chiede un permesso mentre il telefono e' collegato). Puoi aprirla anche dal menu dell'icona:
     "Lascia che il mio iPhone risponda alle richieste di amministratore".
   - Nella finestra vedi cosa viene installato (TightVNC, un piccolo programma open source, raggiungibile solo da questo PC)
     e quali telefoni abbinati potranno rispondere (con l'impronta accanto al nome, tutti spuntati: lascia solo i tuoi).
     Premi "Installa" con il mouse o la tastiera del PC. Non devi copiare nessun file: e' tutto dentro Sprag.
   - Per toglierlo: la stessa voce del menu, la spunta si toglie e Sprag lo rimuove del tutto.
   - TightVNC e' software libero con licenza GPL (versione 2): licenza e fonte sono nella cartella "vendor" accanto a Sprag.exe
     (TightVNC-LICENSE.txt, TightVNC-SOURCE.txt). Sprag prende i file dal pacchetto originale, senza modificarlo, e li installa da solo; in Impostazioni > App non compare nulla.
   - Se in una versione di prova precedente Sprag aveva installato un altro assistente (UltraVNC), viene tolto da solo e te lo dice
     una volta: poi riaccendi la voce del menu per usare il nuovo. Un UltraVNC o un TightVNC installato da te non viene mai toccato:
     in quel caso Sprag non installa nulla e ti dice di toglierlo da Impostazioni di Windows > App.

4. PROVA
   - Muovi un dito sul trackpad: muove il cursore. Tocco = clic, tocco con due dita =
     clic destro, due dita che scorrono = scroll. I tasti Sinistro/Destro sono sotto.
   - Icona tastiera: scrivi sull'iPhone e il testo appare sul PC (anche accenti ed emoji).
   - Icona "play": volume, brano successivo/precedente, mostra desktop, blocca il PC.

4b. NOVITA' M1 (da provare)
   - Pulsante "Mostra desktop" (Win+D) nella barra principale dell'app.
   - Scheda "App": elenco delle finestre aperte con icona; per ciascuna Mostra (la porta in primo piano),
     Riduci, Ingrandisci, Chiudi (chiude con garbo, come la X: non "uccide" mai il programma).
     Windows a volte impedisce di portare in primo piano una finestra da un programma in background:
     in quel caso il pulsante della barra delle applicazioni lampeggia.
   - Tasti speciali: Ins, Canc, Home, Fine, Pag su/giu, Stamp, Pausa, Bloc Scorr, Bloc Num, F1-F24, Esc, Tab,
     frecce, Win, tasto menu; Ctrl/Alt/Maiusc/Win "appiccicosi" per combinazioni (Alt+F4, Win+Maiusc+S).
     NOTA: Ctrl+Alt+Canc dal telefono arrivera' insieme al punto 3c.
   - Alimentazione: Blocca, Sospendi, Riavvia, Arresta, Disconnetti (con conferma sul telefono). Riavvia/Arresta partono
     dopo 30 secondi e si possono annullare dal PC (avviso), dal telefono o con "shutdown /a". Per disattivarli:
     Impostazioni > "Il controllo completo include" > "Riavvia, spegni, disconnetti" (o lo stesso interruttore nel menu
     dell'icona > "Cosa può fare il telefono").
   - Accendere il PC (Wake-on-LAN): serve configurare BIOS e scheda di rete. Menu dell'icona > "Aiuto Wake-on-LAN"
     (o il pulsante nella finestra principale): mostra i controlli su questo PC e la guida passo-passo in italiano.
   - Appunti: "Invia appunti" copia testo/immagine dall'iPhone al PC; "Prendi appunti del PC" li porta sul telefono.
     Limiti: testo 1 MB, immagini 8 MB. iOS mostra la richiesta "Incolla" quando l'app legge gli appunti: e' normale.
   - Novita' (versione 2): il menu dell'icona ha "Cosa può fare il telefono" con un interruttore per ogni funzione:
     aprire app e giochi (Start, Steam, Playnite, Xbox), aprire link web (solo http/https), scrivere testo negli
     appunti (Siri/Comandi rapidi), brano in riproduzione, stato del PC (CPU, GPU, memoria, disco: niente temperature),
     controllo di download e copie. "Consenti azioni dell'IA" e "Condividi questo schermo" sono SPENTI di default.
     "Download e copie": scegli una cartella o un file da sorvegliare; quando la copia finisce (dimensione ferma
     per 15 secondi) il PC avvisa il telefono e, se vuoi, si blocca o va in stop. I download Steam si rilevano da soli.
     Playnite: copia la cartella "playnite-extension" in %APPDATA%\Playnite\Extensions\SpragExport (vedi README.md dentro).
   - Mouse aereo: inclina il telefono per muovere il cursore (tieni premuto il pulsante).
   - Come prima, non controlla finestre avviate "come amministratore" (UIPI), ne' la schermata UAC / di accesso.
     Per agire su una finestra amministratore avvia anche Sprag come amministratore.

5. ICONA NELL'AREA DI NOTIFICA (accanto all'orologio; su Windows 11 puo' essere sotto la freccia "^")
   - Clic sinistro: se nessun telefono e' collegato mostra la finestrella con il codice QR, se un telefono e' collegato
     mostra la finestra "Connesso" (telefono, pausa, cosa sta guardando Sprag).
   - Clic destro: menu (nomi come li mostra Windows in italiano):
       "Mostra il codice di abbinamento"  (per un altro telefono)
       "Impostazioni..."
       "Consenti il controllo remoto"     (spegne/accende l'ascolto)
       "Avvia con Windows"                (avvio automatico; vedi sotto)
       "Cosa può fare il telefono"        (un interruttore per ogni funzione)
       "Download e copie"                 (cartella o file da sorvegliare, cosa fare a fine copia)
       "Aiuto Wake-on-LAN"
       "Cerca aggiornamenti"              (vedi 1b)
       "Aggiorna automaticamente"
       "Apri la cartella dei log"
       "Esci"
   - "Avvia con Windows": e' ACCESO di default, ma solo dopo che hai abbinato il primo telefono (mai al primo avvio, di
     nascosto). Se lo accendi o spegni tu, Sprag rispetta la tua scelta. All'avvio automatico Sprag parte nascosto.
   - Chiudere la finestra con la X non chiude Sprag: resta nell'area di notifica. Si esce solo da "Esci".

5b. CONTROLLO DEL BLUETOOTH (una volta sola, facoltativo)
   - Il Bluetooth di riserva funziona solo se la scheda del PC puo' fare da periferica Bluetooth LE.
   - Apri PowerShell o il Prompt dei comandi nella cartella di Sprag e scrivi:   .\Sprag.exe --ble-check
     Il risultato compare in QUELLA finestra del terminale (se il prompt torna prima del testo, premi Invio).
     Se lanci il comando senza terminale (collegamento, Esegui) compare invece una finestra "Controllo Bluetooth di Sprag".
   - Serve "Ruolo periferica (necessario): sì" e la riga finale "OK". Con "NON OK" il Bluetooth di riserva non e'
     disponibile su questo PC (le Impostazioni lo dicono) e Sprag funziona comunque via Wi-Fi.

6. LIMITI NOTI DI QUESTA VERSIONE
   - Non controlla finestre avviate "come amministratore", le richieste UAC e la
     schermata di accesso (limite di Windows).
   - Se il PC e l'iPhone non si trovano da soli (Bonjour), usa il QR o l'indirizzo.

7. COSA MI SERVE DA TE (feedback)
   - Si trova il PC dall'iPhone nell'elenco "PC vicini"? (se no: va bene il QR?)
   - Il cursore e' fluido? Quanto ritardo senti? Velocita' del puntatore ok?
   - Lo scroll a due dita e il clic destro funzionano?
   - I tasti speciali (Esc, Tab, Win, frecce) e il testo con accenti funzionano?
   - Il PC si blocca / il volume cambia quando premi quei pulsanti?
   - Allega il file di log: tasto destro sull'icona > "Apri la cartella dei log"
     (e' la cartella %LOCALAPPDATA%\Sprag\logs: un file al giorno, sprag-AAAAMMGG.log, gli ultimi 7 giorni).
     Il log non contiene mai quello che scrivi.

Sicurezza: ogni pacchetto e' cifrato e autenticato, l'abbinamento richiede il codice
che vedi solo sul PC, e non esiste alcuna funzione per eseguire comandi: solo mouse,
tastiera, testo e un elenco fisso di azioni (media, volume, blocca PC, mostra desktop, e, se le lasci attive, aprire un'app o un
link web che il PC stesso ti ha elencato).
