Files
Febe/docs/guida/Installazione-Windows.md
T

132 lines
8.9 KiB
Markdown

# Installazione su Windows
> **Stato (13 ottobre 2026).** L'applicazione per Windows (tappa M6) c'è: programma di installazione e versione
> portabile. 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 di sistema, programma di
> installazione). Le tre prove che si possono fare solo lì (S1, S2, S3) sono aperte: vedi
> [Ipotesi da verificare](Ipotesi-da-verificare). I dettagli tecnici sono nel repository, in `docs/windows.md`.
## Com'è fatta
- Un'applicazione Windows (WPF, .NET 10) in un solo file, `Febe.exe`, con l'icona nell'area di notifica. **Un solo
Febe per cartella dei dati**: riaprendolo mentre è già aperto, torna in primo piano la finestra che c'è.
- La finestra di Febe mostra la stessa interfaccia della versione Docker, servita da Febe stesso solo su `127.0.0.1`,
su una porta scelta a ogni avvio e protetta da un gettone che conosce solo la finestra.
- Il browser di Instagram è una **seconda finestra, «Browser di Febe»**: WebView2 (il motore di Edge) con il suo
profilo nella cartella dei dati. La porti in primo piano con «Apri il browser» (Attività, striscia di un arresto) o
«Portalo in primo piano» (Collegamento). Quando non serve **non è chiusa né ridotta a icona**: resta aperta ma fuori
dallo schermo, perché deve continuare a caricare e scorrere (ipotesi S2). Salvataggio delle password e compilazione
automatica sono spenti.
- Ciò che scrivi nella finestra del browser va direttamente alla pagina di Instagram: Febe non riceve la password.
Mentre usi il browser il motore resta fermo; quando hai finito chiudi la finestra (o «Ho finito»): torna fuori vista.
- Funzioni di Windows offerte all'interfaccia: scelta di una cartella, «Mostra nella cartella», indirizzi aperti nel
tuo browser predefinito (mai nel browser di Febe), notifiche di Windows, avvio con il computer.
## 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.
- Un disco locale per la cartella dei dati.
## Installare
1. Scarica `Febe-Setup-<versione>.exe` dalla pagina delle release del repository,
<https://gitea.encke-hake.ts.net/Alby96/Febe/releases>, 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 lasci la scelta «Collegamento sul desktop», uno sul desktop. Febe compare in Impostazioni di Windows ▸
App installate.
4. Alla fine, «Apri Febe adesso» lo avvia.
Non serve installare .NET: `Febe.exe` (circa 86 MB) contiene il runtime, l'interfaccia e le librerie native. Al primo
avvio Windows estrae le librerie native in `%TEMP%\.net\Febe`: è normale.
**Versione portabile.** `Febe-<versione>-portabile.zip`, dalla stessa pagina, contiene lo stesso `Febe.exe`: lo
estrai dove vuoi e lo apri, senza installazione. Anche la versione portabile tiene i dati in `%LOCALAPPDATA%\Febe` e
la libreria in `Immagini\Febe`, finché non scegli altre cartelle.
## Area di notifica e avvio con il computer
- L'icona di Febe sta nell'area di notifica, accanto all'orologio. Un clic apre la finestra; il menu ha **Apri**,
**Metti in pausa** (o **Riprendi**) ed **Esci**.
- **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**, che ferma tutto in ordine e chiude il browser in modo pulito, così la sessione resta
scritta nel profilo.
- «Avvia Febe all'accensione del computer» (Impostazioni ▸ Generali ▸ Avvio) scrive il valore `Febe` in
`HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run`, solo per il tuo utente: all'accensione Febe parte
con `--nascosto`, cioè con la sola icona e senza finestra.
- Gli avvisi arrivano anche come **notifiche di Windows**, dall'icona di Febe; un clic sulla notifica apre Febe. Si
regolano in Impostazioni ▸ Notifiche: vedi [Avvisi e Telegram](Avvisi-e-Telegram).
## Dove stanno le cose
| Che cosa | Predefinita | Che cosa contiene |
|---|---|---|
| Programma | `%LOCALAPPDATA%\Programs\Febe\Febe.exe` | Per la versione portabile, dove l'hai estratto |
| Dati | `%LOCALAPPDATA%\Febe` | Database `febe.sqlite`, **profilo del browser con la sessione di Instagram** (`browser\`), miniature, copie del database (`copie\`), registro (`registro\`) |
| Libreria | `Immagini\Febe` | Foto e video, una cartella per account |
- **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:
ogni file viene copiato, riletto e confrontato con l'originale; solo se tutte le copie sono uguali Febe usa la nuova
cartella e cancella la vecchia (che conteneva una copia della sessione). Se qualcosa va storto resta in uso la
vecchia, intatta. Per farlo subito: Esci e riapri Febe.
- La cartella dei dati **deve stare su un disco locale**: SQLite e il profilo del browser non reggono le condivisioni
di rete. Se la trova in rete, Febe non avvia il motore e mostra solo la pagina che spiega il problema.
- Le copie del database e la ricostruzione dalla libreria: [Copie e ricostruzione](Copie-e-ricostruzione).
## Il primo avvio
Febe si apre sulla schermata di benvenuto con due pulsanti: «Collegati a Instagram» e «Importa foto e video che hai
già». Il collegamento si fa nella finestra «Browser di Febe»: continua da [Primo collegamento](Primo-collegamento).
## Un account, un motore
Se usi anche il contenitore Docker, **non collegare i due Febe allo stesso account Instagram**: contenitore e desktop
non vanno usati insieme sullo stesso account, perché due motori sommano le visite e raddoppiano il rischio. La
sessione nasce nel browser di quella macchina: i cookie non si copiano da una macchina all'altra. Per un secondo
account serve un secondo Febe con cartelle tutte sue: `Febe.exe --dati D:\FebeSecondo --libreria D:\FotoSecondo`.
## Chi ha la cartella dei dati ha la sessione
`%LOCALAPPDATA%\Febe` contiene la sessione di Instagram: chi ha quella cartella, o una sua copia (per esempio in un
backup del profilo di Windows), ha accesso al tuo account. Trattala come una password: niente copie su chiavette,
cartelle condivise o servizi di sincronizzazione. `%LOCALAPPDATA%` non è sincronizzato da OneDrive: lasciala lì. Vedi
[Sicurezza e riservatezza](Sicurezza-e-riservatezza).
## 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` o `edge` | Come è ospitato il browser di Instagram (prove dell'ipotesi S2); la scelta resta per gli avvii successivi |
Le opzioni per lo sviluppo e le prove con il sito di prova sono in `docs/windows.md`.
## Disinstallare
Impostazioni di Windows ▸ App ▸ App installate ▸ Febe ▸ Disinstalla. Prima esci da Febe (menu dell'icona ▸ Esci): con
Febe aperto la disinstallazione chiede di chiuderlo e non toglie nulla.
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.
## Se qualcosa non va
- **«Manca il runtime WebView2 di Microsoft»** all'avvio: installalo dalla pagina ufficiale (il messaggio offre di
aprirla), poi riapri Febe.
- **Il collegamento risulta perso dopo un riavvio** o **il browser sembra fermo mentre è fuori vista**: sono le
ipotesi S3 e S2; riferiscilo con l'ora e il registro di quel giorno (vedi [Ipotesi da verificare](Ipotesi-da-verificare)).
- Il registro è in `%LOCALAPPDATA%\Febe\registro\febe-AAAA-MM-GG.log`: azioni ed esiti, mai password, cookie, tasti o
contenuti. Altri casi: [Problemi comuni](Problemi-comuni).