Files
Febe/docs/windows.md
T
2026-10-14 00:59:18 +00:00

16 KiB
Raw Blame History

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: https://developer.microsoft.com/microsoft-edge/webview2/ (installazione «Evergreen», senza permessi di amministratore).
  • Nessun permesso di amministratore: Febe si installa solo per il tuo utente.

Installazione

  1. Scarica Febe-Setup-<versione>.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-<versione>-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 "<cartella>": 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> Cartella dei dati diversa (un secondo account, le prove); «Cambia…» allora non c'è
--libreria <cartella> 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 <secondi> 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):

installer/costruisci.sh            # versione di Directory.Build.props
installer/costruisci.sh 0.2.0      # oppure una versione esplicita

Il risultato è in out/: Febe-Setup-<versione>.exe e Febe-<versione>-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