Files
Febe/docs/guida/Libreria.md
T

98 lines
5.5 KiB
Markdown

# Libreria
La **Libreria** è il mosaico di tutti gli elementi in ordine di pubblicazione, raggruppati per giorno. Resta fluida
anche con centinaia di migliaia di elementi: carica a finestre e le miniature si generano una volta sola.
## Filtri e ricerca
- **Tipo:** Tutto, Foto, Video, Storie, In evidenza, Taggati. «Foto» e «Video» riguardano i post (un post con almeno
una foto, o almeno un video); storie, evidenza e taggati hanno la loro voce. «Tutto» non comprende le foto del
profilo, che stanno nella scheda dell'account.
- **Account**, **Periodo** (ultimi 7 o 30 giorni, quest'anno, l'anno scorso, oppure dal… al…), **Provenienza**
(scaricati da Instagram o importati). Ogni menu mostra il nome del filtro finché non scegli un valore.
- **Ricerca** per nome dell'account e testo della didascalia (senza distinguere maiuscole e accenti).
- Il cursore accanto a «Seleziona» regola la grandezza delle tessere. Sulle tessere: durata per i video, numero dei file
per i post con più file, anello tratteggiato per le storie.
I nuovi elementi compaiono in cima senza spostare ciò che stai guardando.
## Il visualizzatore
Un clic su una tessera apre l'elemento a tutta finestra: frecce (anche da tastiera) per scorrere, Esc per chiudere, i
video partono senza audio. A lato: la serie dei file, didascalia, dati (data, codice, autore, raccolte), file
(nome, dimensioni, peso, cartella) e provenienza. Azioni:
- **Mostra nella cartella** (Windows) oppure **Scarica** il file (dal browser, in Docker);
- **Apri su Instagram**, nel tuo browser;
- **Elimina dalla libreria**.
## Eliminare
Eliminare chiede conferma. I file vengono cancellati dal disco e non si recuperano.
- **«Elimina dalla libreria»** (il predefinito) ricorda la scelta: l'elemento resta nell'elenco come «eliminato» e non
viene scaricato di nuovo.
- **«Eliminalo e lascia che torni»**: Febe dimentica l'elemento; se è ancora su Instagram, al prossimo controllo lo
scarica di nuovo.
L'eliminazione si scrive prima nel file `_febe.jsonl` dell'account, poi nel database, poi sul disco: anche una
ricostruzione del database la rispetta.
**La libreria non cancella e non sostituisce mai un file da sola.** Se un contenuto sparisce da Instagram, il file
resta. Un file si elimina o si sostituisce solo per una scelta tua.
## Selezione multipla
«Seleziona» attiva la scelta delle tessere; nella barra in basso: **Esporta l'elenco** degli elementi scelti oppure
**Elimina** (con la stessa conferma di sopra). «Fine» chiude la selezione.
## Esportare l'elenco in CSV
Il pulsante con l'icona del documento nella riga degli strumenti, **«Esporta l'elenco»**, scarica in un file CSV
l'elenco degli elementi **mostrati dai filtri di adesso** (senza filtri: tutta la libreria). Con la selezione multipla
si esportano solo gli elementi scelti.
Il file si chiama `febe-elementi-AAAA-MM-GG.csv` ed è fatto per aprirsi bene in Excel con le impostazioni italiane:
`;` come separatore, codifica UTF-8 con BOM, date e ore locali. Colonne: Account, Tipo, Data, Ora, Codice,
Identificativo, Didascalia, Autore, Raccolte, Provenienza, Stato, File, Nomi dei file, Indirizzo. I campi che Excel
leggerebbe come formula (che cominciano con `=`, `+`, `-`, `@`) ricevono un apostrofo davanti.
Il CSV contiene le didascalie: trattalo come i dati che descrive.
## Doppioni dopo uno scaricamento
Quando Febe scarica una foto che sembra la stessa immagine già salvata nello stesso account (stessa immagine, file
diverso), le tiene entrambe e mette la coppia in **«Doppioni da decidere»** (collegamento nella riga degli strumenti e
in Attività). Per ogni coppia scegli: tieni il più grande, tieni quello già in libreria, tienili entrambi. Niente si
decide da solo; ciò che scarti non viene riscaricato. Un file identico byte per byte (stesso SHA-256) a uno già
presente nello stesso account non entra due volte: il nuovo viene saltato e, se quello presente era stato importato
senza dati di Instagram, li riceve dall'elemento appena trovato.
## Cartelle e nomi dei file
- **Libreria:** dove finiscono foto e video, una cartella per account. Può stare su un disco di rete.
- **Dati:** database, profilo del browser, miniature, registro, copie. Deve stare su un disco locale.
Due schemi dei nomi, in Impostazioni ▸ Generali ▸ Nomi dei file, con anteprima del risultato. Predefiniti:
```text
{account}\{tipo}\{anno}\{data}_{ora}_{codice}_{n}
{account}\evidenza\{raccolta}\{data}_{ora}_{codice}_{n}
marta.demo\post\2026\2026-10-10_18-22-05_DBx3kQ2_2.jpg
marta.demo\evidenza\Estate 2025\2025-08-02_10-11-12_3391207_1.jpg
```
- Segnaposto: `account`, `tipo`, `anno`, `mese`, `data`, `ora`, `codice`, `n` (posizione del file nell'elemento),
`raccolta`. Un segnaposto sconosciuto è un errore.
- Data e ora nei nomi sono nel tuo fuso; la data di modifica del file è quella di pubblicazione (si può spegnere).
- I nomi sono ripuliti per Windows (caratteri vietati, nomi riservati, punti e spazi finali); un percorso oltre 240
caratteri si accorcia prima nel nome del file, poi nelle cartelle. Un nome già occupato diventa `nome (2).ext`: mai
una sovrascrittura.
- Cambiare lo schema vale per i prossimi file: quelli già salvati non si rinominano.
Ogni cartella di account ha il suo **`_febe.jsonl`**: una riga per ogni elemento salvato (identificativi, date,
didascalia, nomi dei file) e una per ogni eliminazione. Non va modificato né cancellato: è ciò che permette di
ricostruire il database (vedi [Copie e ricostruzione](Copie-e-ricostruzione)). La libreria resta una cartella di file
normali, leggibile anche senza Febe.