# Febe per Windows La veste Windows di Febe (specifica §12): lo stesso motore e la stessa interfaccia del contenitore Docker, in un'applicazione per Windows 10 e 11. La finestra di Febe mostra l'interfaccia; il browser con cui Febe visita Instagram è una **seconda finestra, «Browser di Febe»**, che resta aperta ma fuori vista quando non ti serve. > **Prima di tutto.** Scaricare con un programma è contro le condizioni d'uso di Instagram. Febe va piano per ridurre il > rischio per l'account (ritmo umano, tetti, fermo al primo segnale), ma non può azzerarlo. Le storie che Febe apre > risultano viste da te. > **Stato.** Questa versione è stata costruita e provata su Linux: tutto ciò che non dipende da Windows ha le sue prove > automatiche, ma **nessuna parte che richiede Windows è ancora stata eseguita su un Windows vero** (finestre, WebView2, > area di notifica, registro, programma di installazione). Le prove da fare sono in fondo a questa pagina e in > `docs/prove-dal-vivo.md`, parte C. ## Che cosa serve - Windows 10 o 11 a 64 bit. - Il **runtime WebView2** di Microsoft: c'è già in Windows 11 e in quasi tutti i Windows 10. Se manca, sia il programma di installazione sia Febe lo dicono e offrono la pagina ufficiale: (installazione «Evergreen», senza permessi di amministratore). - Nessun permesso di amministratore: Febe si installa solo per il tuo utente. ## Installazione 1. Scarica `Febe-Setup-.exe` dalla pagina delle release del repository e aprilo. 2. Windows può avvisare che il programma non è firmato (SmartScreen): «Ulteriori informazioni» ▸ «Esegui comunque». 3. Il programma di installazione mette `Febe.exe` in `%LOCALAPPDATA%\Programs\Febe`, crea il collegamento nel menu Start e, se lo lasci scelto, uno sul desktop. Febe compare in Impostazioni di Windows ▸ App installate (editore Alberto Balbo). 4. Alla fine puoi aprire Febe subito. **Versione portabile.** `Febe--portabile.zip` contiene lo stesso `Febe.exe` (e un `LEGGIMI.txt`): si copia dove si vuole e si apre, senza installazione. Anche la versione portabile tiene i dati in `%LOCALAPPDATA%\Febe` e la libreria in `Immagini\Febe`, finché non scegli altre cartelle. `Febe.exe` è un file solo (circa 86 MB): contiene il runtime .NET, l'interfaccia e le librerie native (SQLite, SkiaSharp, WebView2Loader). Al primo avvio Windows estrae le librerie native in `%TEMP%\.net\Febe`: è normale. ## Il primo collegamento a Instagram 1. Apri Febe: la finestra mostra l'interfaccia (la prima volta, la schermata di benvenuto). 2. Vai in **Impostazioni ▸ Collegamento** (o «Collegati a Instagram» dal benvenuto). Si apre in primo piano la finestra **«Browser di Febe»** con la vera pagina di accesso di Instagram. 3. Scrivi tu nome utente, password e l'eventuale codice della verifica in due passaggi **in quella finestra**: vanno direttamente alla pagina di Instagram. Febe non riceve e non salva la password; il salvataggio delle password e la compilazione automatica del browser sono spenti. 4. Quando vedi la tua pagina iniziale di Instagram, torna alla finestra di Febe e premi **«Ho finito»**: Febe controlla che la sessione ci sia (guarda solo se il cookie esiste, mai il suo valore) e rimette il browser fuori vista. 5. La prima sessione arriva qualche minuto dopo, con calma: nei primi giorni i tetti sono ridotti (avvio graduale). La sessione resta nel profilo del browser, in `%LOCALAPPDATA%\Febe\browser`, e sopravvive ai riavvii di Febe e di Windows (ipotesi S3, da confermare: vedi sotto). ### La finestra «Browser di Febe» - Ha una dimensione fissa, sempre la stessa (la pagina è di 1280 × 900 punti), e sotto la pagina una barra con «Indietro», «Ricarica» e l'indirizzo (senza la parte dopo il `?`). - Quando non ti serve **non è chiusa né ridotta a icona**: è aperta ma spostata fuori dallo schermo, perché il browser deve continuare a caricare e scorrere anche quando non lo guardi (ipotesi S2). Non ha un pulsante nella barra delle applicazioni. - La porti in primo piano dalla finestra di Febe: «Apri il browser» (Attività, striscia rossa di un arresto) o «Portalo in primo piano» (Collegamento). - **Mentre la usi il motore resta fermo.** Quando hai finito, chiudila (la X o «Ho finito» nel Collegamento): torna fuori vista e il motore può ripartire. Dopo una verifica, «Riprendi» si accende solo dopo che hai usato il browser. - «Scollega» (Collegamento) chiede conferma, ferma il motore, chiude il browser e cancella `Dati\browser` con la sessione. Per chiudere la sessione anche dal lato di Instagram, prima esci dal sito usando tu il browser. ## Un account, un motore **Non usare insieme Febe per Windows e il contenitore Docker con lo stesso account Instagram.** Due Febe che raccolgono con lo stesso account sommano le visite e raddoppiano il rischio. Lo dice anche la pagina Collegamento. Per un secondo account serve un secondo Febe con cartelle tutte sue (`Febe.exe --dati D:\FebeSecondo --libreria D:\FotoSecondo`). Febe impedisce due avvii sulla stessa cartella dei dati: un secondo avvio porta in primo piano quello già aperto. Vale anche subito dopo uno spostamento della cartella dei dati (il Febe che l'ha spostata tiene anche il nome della nuova) e con due modi di scrivere la stessa cartella (nome corto, `subst`, collegamenti): finché Febe è aperto tiene il file `febe.lock` nella cartella dei dati, e un secondo Febe che lo trova occupato si ferma e lo dice. ## Area di notifica L'icona di Febe (il marchio: un quadrato blu con un anello e una luna) sta nell'area di notifica, accanto all'orologio. Un clic apre la finestra; il menu ha **Apri**, **Metti in pausa** (o **Riprendi**, quando Febe è in pausa o fermo per una verifica) ed **Esci**. Il suggerimento dell'icona dice che cosa sta facendo Febe. **Chiudendo la finestra Febe resta attivo** nell'area di notifica e continua a lavorare (Impostazioni ▸ Generali ▸ Avvio, «Chiudendo la finestra, Febe resta attivo nell'area di notifica», acceso di serie). Per fermarlo davvero: menu dell'icona ▸ **Esci**. Esci ferma tutto in ordine (motore, scaricamenti, browser): il browser si chiude in modo pulito e la sessione resta scritta nel profilo. ### Notifiche di Windows Gli avvisi di §13.3 (verifica richiesta, disconnessione, fermo per rallentamento e fine del fermo, storico completato, formato non riconosciuto e ricetta sospesa, disco quasi pieno) arrivano come notifiche di Windows, dall'icona di Febe. Si scelgono in Impostazioni ▸ Notifiche («Notifiche di Windows» e gli eventi), dove si può aggiungere anche Telegram: gli avvisi sono gli stessi della veste Docker (`AlertService`, nella composizione condivisa), e le notifiche passano dal guscio di Windows (`NativeShellAlertChannel` su `WindowsShell.NotifyAsync`). Un clic sulla notifica apre Febe. La prova dal vivo è la parte D4 di `docs/prove-dal-vivo.md`. ## Avvio con il computer Impostazioni ▸ Generali ▸ Avvio ▸ «Avvia Febe all'accensione del computer». Febe scrive il valore `Febe` in `HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run` (solo per il tuo utente) e all'accensione parte con `--nascosto`: solo l'icona nell'area di notifica, la finestra resta chiusa. Togliendo la spunta il valore sparisce; lo toglie anche la disinstallazione. Un Febe avviato con `--dati` (un secondo account) ha un valore suo, `Febe-` seguito da sedici cifre esadecimali, con `--nascosto --dati ""`: all'accensione parte quella cartella, e l'interruttore di un Febe non accende, non mostra e non toglie l'avvio dell'altro. La disinstallazione toglie anche questi valori, se avviano il Febe.exe disinstallato. ## Dove stanno le cose | Che cosa | Dove | Note | |---|---|---| | Programma | `%LOCALAPPDATA%\Programs\Febe\Febe.exe` | Dove l'hai copiato, per la versione portabile | | **Dati di Febe** | `%LOCALAPPDATA%\Febe` | Database `febe.sqlite`, **profilo del browser con la sessione di Instagram** (`browser\`), dati della finestra dell'interfaccia (`interfaccia\`), miniature, copie del database (`copie\`, sette giorni), registro (`registro\`, quattordici giorni) | | **Libreria** | `Immagini\Febe` | Foto e video, una cartella per account, con `_febe.jsonl` | - **Chi ha la cartella dei dati, o una sua copia, ha la sessione di Instagram.** Trattala come una password: niente copie su chiavette, cartelle condivise o servizi di sincronizzazione (OneDrive, Dropbox…). `%LOCALAPPDATA%` non è sincronizzato da OneDrive: lasciala lì. - La cartella dei dati deve stare su un **disco locale**: su una cartella di rete Febe non parte e lo spiega. - **Cambiare la libreria** (Impostazioni ▸ Generali ▸ Libreria ▸ «Cambia…»): vale subito per i nuovi file; gli account che hanno già file restano nelle loro cartelle. Febe non sposta nessun file. - **Cambiare la cartella dei dati** (Impostazioni ▸ Generali ▸ Dati di Febe ▸ «Cambia…»): la nuova cartella deve essere vuota e su un disco locale. Lo spostamento avviene **al prossimo avvio**, prima che Febe apra qualunque cosa: copia ogni file, lo rilegge e ne confronta lo SHA-256 con l'originale; solo se tutte le copie sono uguali usa la nuova cartella e cancella la vecchia (che conteneva una copia della sessione). Se qualcosa va storto la vecchia cartella resta quella in uso, intatta, e la copia parziale viene tolta. Per farlo subito: Esci e riapri Febe. La cartella scelta è scritta in `HKEY_CURRENT_USER\Software\Febe` (`CartellaDati`); con `--dati` decide invece la riga di comando. ## Riga di comando | Opzione | Che cosa fa | |---|---| | `--nascosto` | Parte con la sola icona nell'area di notifica (lo usa l'avvio con il computer) | | `--dati ` | Cartella dei dati diversa (un secondo account, le prove); «Cambia…» allora non c'è | | `--libreria ` | Libreria di partenza diversa (una cartella scelta poi nelle Impostazioni vince) | | `--browser finestra\|composizione\|edge` | Come è ospitato il browser di Instagram (prove di S2, sotto); la scelta resta per gli avvii successivi | | `--sviluppo` | Strumenti di sviluppo nella finestra dell'interfaccia (mai nel browser di Febe) | | `--sito-di-prova http://127.0.0.1:8481` | Sviluppo e prove: il browser lavora sul sito di prova locale invece che su Instagram | | `--accesso-di-prova` | Solo con `--sito-di-prova`: apre il sito una volta, come dopo un accesso | | `--prima-sessione ` | La prima sessione dopo questi secondi invece che dopo 2–10 minuti | ## Sicurezza dell'interfaccia L'interfaccia è servita da Febe stesso su `127.0.0.1`, su una porta scelta a ogni avvio, e risponde solo con il **gettone di quell'avvio**, che conosce solo la finestra di Febe: la finestra apre `/?gettone=…` una volta, il gettone diventa un cookie `HttpOnly`, `SameSite=Strict` e sparisce dall'indirizzo. Si controllano anche `Host` e `Origin`: un'altra pagina aperta nel tuo browser non può comandare Febe. Gli indirizzi esterni (guida, repository, «Apri su Instagram») si aprono nel tuo browser predefinito, mai nel browser di Febe. ## Il browser di Febe e le ipotesi S1–S3 Su Windows il browser di Instagram è WebView2 (il motore di Edge), pilotato con il protocollo DevTools attraverso `CallDevToolsProtocolMethodAsync` e `GetDevToolsProtocolEventReceiver` (non il pacchetto `DevToolsProtocolExtension`, deprecato), con lo **stesso elenco di comandi ammessi** del Chromium di Docker e gli stessi rifiuti: nessun comando fuori elenco arriva al browser, `Runtime.evaluate` solo in lettura, nel registro solo i nomi dei comandi. Per S2 (la pagina deve continuare a caricare e scorrere quando la finestra non è in vista) ci sono tre modi, nell'ordine della specifica (§6.6); si sceglie con `--browser` e la scelta resta: 1. **`finestra`** (predefinito): la finestra «Browser di Febe» aperta ma fuori dallo schermo; il controllo WebView2 resta sempre «visibile» (`IsVisible` vero: se diventa falso WebView2 smette di disegnare) e il rilevamento dell'occlusione è spento dagli argomenti del browser: `--disable-features=CalculateNativeWinOcclusion` e `--disable-backgrounding-occluded-windows`. Non sono vietati dalla regola 2: cambiano come il browser organizza il proprio lavoro, non ciò che dichiara (user agent, client hints, `navigator`, lingua, fuso e intestazioni restano quelli di un Edge normale; nella pagina non entra nulla). 2. **`composizione`**: lo stesso, con WebView2 ospitato come visual di DirectComposition invece che come finestra figlia; Febe passa al browser il mouse e il puntatore della zona della pagina. 3. **`edge`**: Microsoft Edge avviato come processo e pilotato come il Chromium di Docker (`ChromiumProcessHost`, porta di debug fissa 9222 solo su 127.0.0.1), profilo in `Dati\browser\edge`; la sua finestra viene spostata fuori dallo schermo. Se Edge non c'è, Febe usa la `finestra`. Ogni Edge avviato da Febe sta in un *job object* di Windows che lo chiude insieme a Febe.exe, anche se Febe si chiude all'improvviso o da Gestione attività: un Edge rimasto aperto terrebbe la porta 9222 e il browser di Febe non ripartirebbe più. Le prove da fare su un Windows vero, con la procedura esatta, sono in `docs/prove-dal-vivo.md`, **parte C**. In breve: - **S1** — con il sito di prova: una sessione intera (gesti, corpo delle risposte, scaricamenti) e l'anteprima di Attività. - **S2** — la stessa sessione con il browser fuori vista, con la finestra di Febe ridotta a icona e con lo schermo bloccato; poi, se serve, `composizione` e `edge`. - **S3** — accesso a mano, «Esci», riapertura, riavvio di Windows: il collegamento deve restare. ## Disinstallare Impostazioni di Windows ▸ App ▸ App installate ▸ Febe ▸ Disinstalla (oppure «Disinstalla Febe.exe» nella cartella del programma). Prima esci da Febe (menu dell'icona ▸ Esci). La disinstallazione toglie il programma, i collegamenti, la voce in App installate e l'avvio con il computer. **Non cancella mai la cartella dei dati né la libreria** e non chiede nulla su di loro: alla fine dice dove sono. Se non ti servono più, cancellale tu — la cartella dei dati contiene la sessione di Instagram. ## Costruire il programma di installazione Da Linux (CI, rilascio) o da Windows con bash, con il .NET SDK 10 e NSIS 3 (`apt-get install nsis`): ```sh installer/costruisci.sh # versione di Directory.Build.props installer/costruisci.sh 0.2.0 # oppure una versione esplicita ``` Il risultato è in `out/`: `Febe-Setup-.exe` e `Febe--portabile.zip`, ognuno sotto i 100 MB (limite degli allegati di Gitea; con la versione 0.1.0: Febe.exe 86 MB, installazione 80 MB, zip 81 MB). Lo script controlla che la pubblicazione abbia prodotto un solo file e che nulla superi il limite. Lo script NSIS è `installer/febe.nsi` (Unicode, testi in italiano, versione passata con `/DVERSION=…`). L'icona `src/Febe.Desktop/Febe.ico` (16, 24, 32, 48, 64, 128 e 256 pixel) è disegnata dal marchio dell'appendice C con SkiaSharp e scritta a mano: per rigenerarla dopo un cambio del marchio, `FEBE_RIGENERA_ICONA=1 dotnet test tests/Febe.Tests --filter IconTests`. ## Problemi comuni | Che cosa vedi | Che cosa fare | |---|---| | All'avvio: «Manca il runtime WebView2 di Microsoft» | Installa il runtime dalla pagina ufficiale (il messaggio offre di aprirla), poi riapri Febe | | «La cartella dei dati è su un disco di rete» o «non può scrivere» | Riapri Febe con una cartella dei dati su un disco locale (`--dati`), oppure libera la cartella | | Aprendo Febe si porta solo in primo piano la finestra già aperta | È voluto: un solo Febe per cartella dei dati. Per fermarlo: menu dell'icona ▸ Esci | | Il collegamento risulta perso dopo un riavvio | È l'ipotesi S3: riferiscilo (parte C di `docs/prove-dal-vivo.md`) con l'ora e il registro di quel giorno | | Il browser sembra fermo mentre è fuori vista | È l'ipotesi S2: prova `Febe.exe --browser composizione`, poi `--browser edge`, e riferisci | | Il registro | `%LOCALAPPDATA%\Febe\registro\febe-AAAA-MM-GG.log`: azioni ed esiti, mai password, cookie, tasti o contenuti |