PrivacyRemover - Installazione Linux
====================================

Requisiti
---------
- Linux x86_64 o arm64 (distribuzione recente)
- Node.js 22 o superiore (nodejs + npm dal gestore pacchetti o da nodejs.org)
- Browser per l'interfaccia web (Firefox, Chrome/Chromium, Edge)
- Opzionale, solo per la ricerca tramite browser: Playwright Chromium

Installazione
-------------
1. Estrai lo ZIP in una cartella (es. ~/PrivacyRemover).
2. Apri un terminale nella cartella ed esegui:
     chmod +x Avvia_PrivacyRemover.sh
3. Avvia:
     ./Avvia_PrivacyRemover.sh
4. Al primo avvio viene eseguito "npm install", la compilazione e la creazione
   della PASSWORD MASTER (almeno 12 caratteri, non salvata).
5. Il browser si apre su http://127.0.0.1:4317/ quando il server e pronto.

Se il browser non si apre, visita manualmente http://127.0.0.1:4317/.
La finestra del terminale deve restare aperta; Ctrl+C ferma il server.

Variabili utili
---------------
- Porta alternativa:
    PR_PORT=4321 ./Avvia_PrivacyRemover.sh
- Senza apertura automatica del browser:
    PR_NO_BROWSER=1 ./Avvia_PrivacyRemover.sh
- Ricerca tramite browser (opzionale):
    npx playwright install chromium
  In alternativa usa un Chrome di sistema:
    PRIVACY_REMOVER_BROWSER_CHANNEL=chrome ./Avvia_PrivacyRemover.sh
  Se Chromium non parte per librerie di sistema mancanti (es. libnspr4.so):
    sudo npx playwright install-deps chromium
  La ricerca HTTP diretta funziona anche senza Playwright.
- Dati in una cartella diversa:
    PRIVACY_REMOVER_DATA_DIR=~/dati-privacy ./Avvia_PrivacyRemover.sh

Dati e sicurezza
----------------
I dati stanno in ~/.privacy-remover (database cifrato, salt, report, outbox).
Il server ascolta solo su 127.0.0.1, quindi non e raggiungibile dalla rete.

Le password SMTP/IMAP sono conservate in ~/.privacy-remover/secrets.json con
permessi 0600 (su Windows si usa DPAPI; l'integrazione con il keyring di
desktop, es. libsecret, non e ancora implementata). Proteggi il tuo account
e limita l'accesso alla cartella dati.

Se perdi la password master e il file kdf.salt, il database non e recuperabile.
Fai un backup di tutta la cartella ~/.privacy-remover.

Problemi comuni
---------------
- "Node.js non trovato": installa Node 22+ e riapri il terminale.
- Errori di compilazione del modulo SQLite: assicurati di avere gli strumenti
  di build (build-essential/python3 su Debian/Ubuntu) e ripeti npm install.
- Porta occupata: imposta PR_PORT=4321 prima di avviare lo script.
- Browser Playwright assente: esegui "npx playwright install chromium" oppure
  imposta PRIVACY_REMOVER_BROWSER_CHANNEL=chrome.
- Chromium non parte per librerie mancanti (libnspr4.so, libnss3.so):
  esegui "sudo npx playwright install-deps chromium" (richiede sudo).

Nessuna consulenza legale: le richieste GDPR vanno verificate e seguite.
