maksit-postclient/README.it.md

Postclient — client PEC, REM e IMAP da scrivania

Lingua: English · Italiano · Français · Deutsch · Español

L’interfaccia del programma è in inglese, italiano, francese, tedesco o spagnolo. Questi documenti descrivono lo stesso client di posta elettronica da scrivania open source per chi invia e conserva posta elettronica certificata (PEC), registered electronic mail (REM) eIDAS e posta IMAP / POP3 / SMTP ordinaria su Windows, Linux e macOS.

Postclient è un client locale, non una webmail. Si collega con IMAP, POP3 e SMTP alle caselle che già possiedi: Gmail, Microsoft 365, PEC italiana presso un gestore qualificato (Aruba, InfoCert Legalmail, Namirial, Poste Italiane, Register.it, Libero, e IMAP su dominio personalizzato), e REM europea quando l’operatore espone IMAP/SMTP. Le ricevute restano su questo PC come .eml più un archivio SQLite ricercabile.

Non è un prestatore di servizi fiduciari qualificati (QTSP), non è un gestore PEC, non è una marca temporale e non è una casella in cloud. Buste e ricevute le emette il gestore / QTSP. Questo programma le apre, mostra l’evidenza di consegna e tiene gli originali sulla macchina.

Tipo	Client di posta da scrivania per PEC, REM e IMAP
Sistemi	Windows, Linux, macOS (Apple Silicon e Intel)
Stack	C#, .NET 10, Avalonia, MailKit
Licenza	Apache 2.0
Non è	Un QTSP, un nuovo indirizzo PEC/REM, posta ospitata, un’app scanner

Modifiche: CHANGELOG.md. Sviluppo: CONTRIBUTING.md e README in inglese (compilazione, test, release).

Pensato per la posta certificata sul desktop

La posta da scrivania e la webmail trattano di solito una busta PEC o una parte di evidenza ETSI REM come un allegato qualunque. Postclient è scritto intorno a quella evidenza:

• Apre buste PEC / REM — legge il postacert.eml interno (il messaggio destinato al destinatario) invece del wrapper del gestore; colonna Tipo PEC, RIC, REM o SIG (firmato digitalmente).
• Colonna consegna dall’evidenza dell’operatore — accettazione, avvenuta-consegna, ETSI SubmissionAcceptance / Delivery / Retrieval, LRE e avis AR24, Zustellung e Abholbestätigung De-Mail, acuse de recibo. Dopo l’invio SMTP, Inviata viene abbinata alle ricevute in Posta in arrivo/Ricevute tramite Message-Id, daticert.xml e prefissi oggetto. La PEC italiana non ha ricevuta di lettura: avvenuta consegna è il deposito nella casella certificata.
• Anteprima FatturaPA — XML della fattura elettronica italiana in una vista leggibile (parser XML, non intelligenza artificiale).
• Fascicolo di .eml originali — esporta i messaggi selezionati come i file che un notaio, uno sportello PA, una banca o un giudice può conservare.
• Da è un selettore di casella — non si digita un From libero; l’invio usa l’identità SMTP dell’account collegato.
• Etichette di pratica su questo PC — condominio, fascicolo cliente, avviso IMU. Le etichette sono locali, non un database di studio in rete.
• Archivio locale di tutta la cartella — Scarica messaggi memorizza tutta la cartella IMAP in mail.db più gli .eml su disco (non una finestra degli ultimi N). FTS su oggetto, corpo, testo degli allegati PDF/XML/HTML/CSV/JSON e etichette.
• Ricerca per significato sul dispositivo (RAG) — EmbeddingGemma 300M opzionale in Impostazioni → Indici…. I vettori restano in mail.db. La posta non lascia la macchina. Si possono ricostruire o riparare gli indici per parole e per significato.
• Regole tra caselle — sposta, elimina, flag, etichetta; la cartella di destinazione può stare su un altro account, compreso un archivio cartella. Importa JSON o un file .rwz legacy; l’export è JSON.
• Archivi cartella — crea, collega, sposta o sgancia una directory con .eml e il proprio mail.db (parole e significato). Importa PST… copia la posta in un archivio; il .pst non diventa una casella. Percorso predefinito: %LocalAppData%\Postclient\stores\{nome} (portatile: {installazione}/data/stores/{nome}).
• Easy Migration — File → Easy Migration → Crea bundle… chiede la passphrase due volte nella stessa finestra, poi Salva. Il .postbundle contiene posta, account, segreti e la cartella modelli condivisa. Apri bundle… lo ripristina nelle cartelle Postclient di questo PC. La sincronizzazione in background resta spenta.
• Sincronizzazione in background — Impostazioni → Sincronizzazione in background per questo account…: un servizio all’avvio (servizio Windows, unità systemd di sistema su Linux). Sincronizza ogni casella salvata senza che nessuno abbia effettuato l’accesso.
• Spam — Segna come spam ricorda il messaggio su questo PC e insegna a ogni casella, anche dopo che il messaggio o la casella non ci sono più. La posta simile è solo un indizio. Non spam cancella quella memoria e riporta il messaggio in Posta in arrivo. Spostare in Indesiderata non insegna il filtro.
• Pacchetti per Paese — Impostazioni → Funzionalità accende o spegne Italia (PEC, FatturaPA, fascicolo), Europa (REM eIDAS), Francia, Germania, Spagna e Svizzera. L’IMAP ordinario resta disponibile.

A chi serve

Privati

Client quotidiano per uno o più indirizzi: Gmail o Microsoft 365 accanto a una PEC personale (Italia) o a una casella REM IMAP (UE). Cerca un avviso di condominio, un file IMU o una comunicazione della PA anni dopo, senza lasciare gli originali sul server di terzi.

Uso tipico: posta certificata e ordinaria nella stessa finestra; vedere se il gestore ha accettato e depositato la PEC; stampare o salvare un PDF; esportare l’.eml originale se lo chiede il Comune, la banca o il giudice.

Studi e agenzie

Serve quando le identità certificate non devono mescolarsi: PEC personale, PEC dello studio, posta ordinaria. Un commercialista, un avvocato, un notaio, un CAF, un amministratore di condominio o uno studio UE che deposita in PA può tenere ogni casella del gestore distinta (quota IMAP QUOTA in barra di stato), raggruppare un invio con le sue ricevute ed esportare un fascicolo senza caricare la pratica su un archivio di terzi.

Il programma non sostituisce il gestore, non emette una ricevuta qualificata e non condivide le etichette tra i PC dell’ufficio.

Account e protocolli

In ingresso: IMAP (albero cartelle), POP3 (solo Posta in arrivo), o un archivio cartella locale. Un .pst Unicode si può ancora importare in un archivio. In uscita: SMTP. Cifratura: automatica, SSL/TLS, STARTTLS, STARTTLS se disponibile, oppure nessuna. MailKit usa i metodi SASL che il server offre.

Si possono usare più caselle insieme. I profili compilano host e porte:

Profilo	Ruolo
Gmail	IMAP/SMTP; accesso Google (OAuth2 / XOAUTH2) o password per le app Gmail
Microsoft 365	IMAP/SMTP; accesso Microsoft. Quasi tutti questi account rifiutano la password della casella
IT PEC — Aruba	imaps.pec.aruba.it / smtps.pec.aruba.it (POP3: pop3s.pec.aruba.it)
IT PEC — InfoCert Legalmail	mbox.cert.legalmail.it / sendm.cert.legalmail.it. Spesso lo User ID InfoCert, non l’indirizzo
IT/EU PEC — Namirial	imaps.sicurezzapostale.it / smtps.sicurezzapostale.it
IT PEC — Poste Italiane	mail.postecert.it
IT PEC — Register.it	imap.pec-email.com / smtp.pec-email.com
IT PEC — Libero	mail.postacert.it.net
EU — Intesi Group	imap.ig-trustmail.com / smtp.ig-trustmail.com
IMAP / POP3	Qualunque host indicato dall’operatore. Imposta il tipo di casella su PEC italiana o REM UE se quella casella è certificata (anche con dominio personalizzato)
Archivio locale	Cartella su disco (postclient.store.json + mail.db + .eml). Senza password e senza SMTP. Crea, collega, sposta o sgancia dal menu File.

Le caselle IMAP certificate usano la password del gestore, o una password per le app se c’è il 2FA. AR24 (Francia), De-Mail (Germania), IncaMail (Svizzera) e Lleida (Spagna) di solito non sono IMAP. Se l’operatore ha dato host IMAP/POP3, scegli IMAP / POP3. Altrimenti questa applicazione non apre quella casella; può comunque mostrare l’evidenza ETSI REM su messaggi importati come .eml.

Gmail e Microsoft 365 accedono tramite Identity Hub (https://identity.maks-it.com). Impostazioni account apre /desktop-login?provider=Google o Microsoft. Il JWT Hub e il refresh token restano in secrets.bin; IMAP usa un mailbox-token a breve scadenza (XOAUTH2). All’avvio il client rinnova la sessione Hub da quel refresh token, così Gmail e Outlook restano collegati dopo la chiusura. Se una build precedente ha salvato solo il JWT, accedi di nuovo da Impostazioni account. Override: POSTCLIENT_IDENTITY_HUB. La password resta valida per PEC e IMAP generico.

Password e token OAuth stanno accanto alle impostazioni (DPAPI su Windows, mode 600 su Linux/macOS), mai in settings.json.

PEC italiana (posta elettronica certificata)

La PEC è una busta del gestore:

• messaggio di trasporto con X-Trasporto: posta-certificata, daticert.xml e l’originale in postacert.eml;
• ricevute (X-Ricevuta) in Posta in arrivo e Ricevute: accettazione, presa-in-carico, avvenuta-consegna, non-accettazione, mancata-consegna, rilevazione-virus, preavviso-errore-consegna.

Visualizza → Apri busta PEC/REM mostra il postacert.eml interno. La colonna Tipo indica PEC (trasporto) o RIC (ricevuta).

La PEC italiana non ha ricevuta di lettura. Avvenuta consegna significa deposito nella casella certificata del destinatario, non che una persona abbia aperto il messaggio.

REM europea (registered electronic mail eIDAS)

Se il messaggio porta evidenza ETSI REM (REMEvidence / urn:etsi:rem, o un nome parte remevidence / rem-md), il client lo tratta come REM. Gli eventi finiscono nella stessa colonna Consegna della PEC:

• SubmissionAcceptance → il QTSP ha preso in carico;
• Delivery / avis de réception LRE o AR24 / Zustellung De-Mail / acuse de recibo → depositato;
• ContentConsignment / Retrieval / Abholbestätigung De-Mail → il destinatario ha ritirato il contenuto (equivalente europeo più vicino alla “lettura”);
• rifiuto, virus, mancata consegna, DeliveryExpiration → fallito.

S/MIME (smime.p7s / smime.p7m) è mostrato come firmato digitalmente; non è PEC né REM.

Colonna consegna dopo l’invio

Dopo l’SMTP, Postclient memorizza il Message-Id in uscita e, aprendo Inviata, riconcilia le ricevute da Posta in arrivo e Ricevute. L’attesa vale solo per le caselle di tipo PEC o REM (un preset, oppure IMAP/POP3 con quel tipo). Gmail, Microsoft 365 e IMAP ordinario risultano solo inviati. Abbina, in ordine: <msgid> in daticert.xml, X-Riferimento-Message-ID, In-Reply-To, identificativo PEC, poi i prefissi oggetto (ACCETTAZIONE:, CONSEGNA:, AVIS DE RECEPTION:, ACUSE DE RECIBO:, ZUSTELLBESTAETIGUNG:, ABHOLBESTAETIGUNG:, …).

Evidenza	Stato	Significato
PEC accettazione / presa-in-carico, ETSI SubmissionAcceptance	Accettato	Il gestore ha preso il messaggio
PEC avvenuta-consegna, ETSI Delivery, avis LRE/AR24, Zustellung	Consegnato	Depositato nella casella certificata — la PEC non certifica la lettura
ETSI ContentConsignment / Retrieval, Abholbestätigung	Ritirato	Il destinatario ha ritirato il contenuto
non-accettazione, mancata-consegna, virus, rifiuto ETSI	Fallito	Il gestore ha segnalato mancata accettazione o consegna

Il client mostra l’evidenza dell’operatore. Non emette ricevuta qualificata, busta PEC o marca temporale.

Le notifiche del sistema segnalano nuove PEC, ricevute e REM (toast Windows, notifica macOS, notify-send su Linux).

Lettura, cartelle, composizione

• L’albero segue il server (Posta in arrivo, Ricevute, Bozze, Inviata, Archivio, Indesiderata, Cestino, più cartelle personalizzate). I percorsi IMAP nidificati sono cartelle nidificate, comprese le etichette Gmail [Gmail]/… sotto [Gmail]. Bozze, Inviata e Cestino che il server chiama INBOX.Drafts / INBOX.Sent / INBOX.Trash stanno accanto a Posta in arrivo, non sotto. Gmail usa / come separatore: un’etichetta come P.IVA resta una sola cartella. Le cartelle di sistema non si eliminano. Si può creare una cartella, svuotarla (nel Cestino, o in modo definitivo nel Cestino), segnare tutto letto/non letto, eliminare una cartella personalizzata, trascinare i messaggi su una cartella. Quali account e cartelle nidificate sono aperti o chiusi resta in settings.json.
• Colonne elenco: non letto, stella, allegati, consegna, tipo (PEC / RIC / REM / SIG), da, oggetto, data (locale yyyy-MM-dd HH:mm), dimensione, etichetta di pratica.
• Vista: HTML (motore web del sistema), testo, sorgente, o FatturaPA. Disposizione: elenco sopra la lettura, oppure tre colonne (cartelle, elenco, lettura).
• Raggruppa conversazioni indenta le risposte nell’elenco (Message-ID / In-Reply-To / References, profondità massima 8). Le ricevute PEC dello stesso originale stanno insieme. Non c’è un riquadro conversazioni separato.
• Azioni: rispondi, rispondi a tutti, inoltra, apri in nuova finestra, letto/non letto, stella, priorità, segna come spam, non spam, elimina. Maiusc+clic e Ctrl+clic selezionano più messaggi o cartelle. Elimina (barra, Canc, svuota cartella) sposta la selezione nel Cestino. Dal Cestino l’eliminazione è definitiva.
• La composizione è testo semplice. A, Cc, Ccn sono chip di indirizzo. Gli allegati sono elencati nel compositore. Invia allegati come ZIP impacca i file trascinati (password opzionale). L’invio usa solo l’identità SMTP della casella scelta.

HTML: WebView2 su Windows (profilo sotto la cartella dati), WebKitGTK su Linux, WKWebView su macOS. Se manca il motore, si vede il corpo di testo.

Pacchetti Linux per la vista HTML:

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libsoup-3.0-0

Fedora: gtk3 webkit2gtk4.1 libsoup3.

Archivio locale, ricerca per parole e indice di significato

Scarica messaggi indica tutta la cartella IMAP in SQLite (mail.db) più gli .eml su disco. POP3 riempie solo la Posta in arrivo. L’indicizzazione gira in background; la barra di stato mostra l’avanzamento.

• Impostazioni → Indici…: indice per parole (FTS) e, se vuoi, EmbeddingGemma 300M (~300 MB) per il significato. Il pacchetto ONNX si scarica una volta nella cartella della macchina (ProgramData\MaksIT\Postclient\models, o /var/lib/maksit/postclient/models su Linux) ed è condiviso da ogni account e dal servizio di sincronizzazione. I vettori restano in mail.db su questo PC. Dispositivo: Automatico / CPU / GPU (DirectML su Windows). Ricrea o ripara gli indici se la ricerca è storta. I pesi usano i termini Google Gemma. Segni spam… elenca ciò che il filtro ha imparato.

La ricerca (cartella corrente) copre oggetto, corpo, testo degli allegati (PDF e text/XML/HTML/CSV/JSON), etichette di pratica e il significato quando il modello è pronto. La casella di ricerca ha una × che cancella il testo. Le etichette esistono solo su questo PC.

L’archivio è solo su questo PC. File → Apri cartella archivio / Esporta archivio copia mail.db e gli .eml. Percorsi:

OS	Configurazione	Dati
Windows	%AppData%\Postclient\	%LocalAppData%\Postclient\
Linux	~/.config/postclient/	~/.local/share/postclient/
macOS	~/Library/Application Support/Postclient/	stesso

Override: POSTCLIENT_CONFIG / POSTCLIENT_DATA_DIR. Lo zip portatile Windows con installType: portable in settings.json tiene la config accanto all’eseguibile.

La QUOTA IMAP del gestore (se il server la supporta) è una barra sottile sul nodo di quell’account nell’albero. POP3 mostra lo spazio usato da STAT quando il server non ha un limite. Gli archivi locali non hanno quota. È lo spazio della casella presso l’operatore, non uno storage cloud di questa applicazione.

Importazione, esportazione, stampa

Azione	Risultato
Importa EML	Originali nella cartella corrente
Importa mbox	Store mbox locali da un profilo di posta da scrivania
Importa .pst / .ost	Copia la posta Outlook in un archivio cartella (percorso proposto sotto stores/ nei dati app). Un secondo import nello stesso archivio salta i duplicati per Message-ID.
Nuovo archivio	Menu File: cartella vuota con postclient.store.json e mail.db.
Collega archivio	Menu File: cartella che ha già postclient.store.json.
Sposta / Sgancia archivio	Copia l’intera directory, oppure la toglie dall’elenco. La cartella resta sul disco quando si sgancia.
Conservazione	Impostazioni → Conservazione…: giorni per cartella (0 = per sempre). Alla scadenza la posta della cartella va nel Cestino dopo Scarica messaggi. Sul Cestino, 0 lo tiene per sempre e un numero di giorni elimina in modo permanente il Cestino più vecchio.
Sincronizzazione in background	Impostazioni → Sincronizzazione in background per questo account…: servizio all’avvio (servizio Windows, unità systemd di sistema su Linux). Sincronizza ogni casella salvata senza accesso. Condividi questo account fa solo sì che le altre persone su questo PC aprano quella casella.
Account condiviso	Impostazioni account → Condividi questo account con gli altri utenti di questo PC: quella casella passa nella cartella della macchina (ProgramData\MaksIT\Postclient, o Public se ProgramData non è scrivibile; /var/lib/maksit/postclient su Linux; /Users/Shared/MaksIT/Postclient su macOS). Gli altri utenti la vedono aprendo Postclient. Le password non vengono copiate.
Easy Migration	File → Easy Migration → Crea bundle… chiede la passphrase due volte nella stessa finestra, poi Salva. Il .postbundle contiene posta, account, segreti e la cartella modelli condivisa. Apri bundle… lo ripristina su questo PC e riscrive i percorsi degli archivi. La sincronizzazione in background resta spenta.
Segni spam	Segna come spam ricorda il messaggio su questo PC e insegna a ogni casella, anche dopo che il messaggio o la casella non ci sono più. La posta simile è solo un indizio. Non spam cancella quella memoria e riporta il messaggio in Posta in arrivo. Spostare in Indesiderata non insegna il filtro. Impostazioni → Indici… → Segni spam… elenca ciò che è stato imparato.
Aggiornamenti e registro	Aiuto → Controlla aggiornamenti… chiede a GitHub l’ultima release e può scaricare il pacchetto per questo sistema. Aiuto → Registro apre una finestra copiabile sulla cartella dei log. Aiuto → Informazioni su Postclient elenca Info, Privacy, Security e Support su maks-it.com.
Regole	Impostazioni → Regole: Importa regole… legge l’export JSON di questa app o un file .rwz legacy. Esporta regole… scrive JSON. Ogni regola è legata a una casella; la cartella di destinazione può stare su un’altra casella (anche un archivio). Partono su Scarica messaggi, in import e da Esegui tutte le regole.
Stampa	HTML leggibile del messaggio (eventualmente sbustato)
Salva PDF	Lo stesso contenuto in PDF
Salva allegati ZIP	Tutti gli allegati del messaggio aperto
Esporta EML selezionati (fascicolo)	Gli .eml originali — ciò che notaio o PA possono conservare come messaggio

I messaggi aperti sono anche copiati come .eml nella cartella dati. Gli .eml sono gli originali; PDF e stampa sono una copia di lettura.

Lingua dell’interfaccia

Visualizza → Lingua: English, Italiano, Français, Deutsch o Español. I nomi cartella del server (Posta in arrivo, Gesendet, Messages envoyés, Enviados, …) sono mappati su Posta in arrivo / Inviata / … nella lingua dell’UI.

Pacchetti per Paese

Impostazioni → Funzionalità è una matrice di sola posta certificata. IMAP/POP3 ordinario, ricerca, etichette di pratica, import mbox/.pst e file dati collegati restano sempre disponibili. Le righe sono funzioni certificate; le colonne sono Italia, Europa, Francia, Germania, Spagna, Svizzera. La casella in intestazione accende o spegne tutta la colonna.

Pacchetto	Cosa sblocca	Predefinito
Italia	Busta PEC / ricevute / consegna, profili PEC, anteprima FatturaPA, fascicolo	Acceso
Europa	Evidenza REM eIDAS, profilo Intesi	Acceso
Francia / Germania / Spagna / Svizzera	Etichette di evidenza (AR24/LRE, De-Mail, Lleida, IncaMail). Quelle reti di solito non sono IMAP.	Spento

Spegnere un pacchetto nasconde menu, colonne e profili. Le caselle già configurate restano; sparisce solo l’interfaccia extra.

Download

Quando esiste una GitHub Release: zip portatile e setup Windows (postclient-{version}.exe, self-contained — niente SDK .NET sul PC; percorso predefinito C:\Program Files\MaksIT\Postclient), Flatpak Linux, DMG macOS (osx-arm64 e osx-x64). Le build macOS non sono firmate: al primo avvio Apri dal menu contestuale.

Linux (Flatpak)

flatpak install --user ./postclient-{version}.flatpak
flatpak run eu.postclient.desktop

Compilazione da sorgente, test e procedura di release: README in inglese.

Licenza

Apache License 2.0. Copyright 2026 Maksym Sadovnychyy (MAKS-IT).