# 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 |