LetterFeed è un’applicazione open source self-hosted pensata per chi riceve regolarmente newsletter via email e desidera leggerle in modo più comodo e centralizzato. Questa utility consente di convertire automaticamente le email provenienti da mittenti selezionati in feed RSS, rendendole accessibili da qualsiasi lettore compatibile.
Il funzionamento è semplice ma efficace: LetterFeed si collega alla casella di posta dell’utente tramite protocollo IMAP (su porta 993 con SSL), scansiona periodicamente i messaggi in arrivo e, quando rileva una nuova email da un mittente configurato, la elabora e la pubblica come nuovo elemento nel feed RSS corrispondente. In questo modo, è possibile seguire le newsletter direttamente dal proprio aggregatore RSS preferito, senza dover aprire la casella email o gestire manualmente i messaggi.
Questa soluzione è particolarmente utile per chi utilizza Linux e preferisce strumenti decentralizzati, privi di dipendenze da servizi cloud o piattaforme proprietarie. LetterFeed è pensato per essere eseguito in locale o su server privati, garantendo il pieno controllo sui dati e sulla configurazione.
LetterFeed: Requisiti, installazione e configurazione su Linux
Per utilizzare LetterFeed su Linux, è necessario disporre di alcuni requisiti di base:
- Una casella email con accesso IMAP su porta 993 (SSL)
- Docker e Docker Compose installati sul sistema
- Un editor di testo per modificare i file di configurazione
L’installazione è semplice e segue i passaggi tipici di un progetto containerizzato. Dopo aver clonato il repository ufficiale da GitHub, è necessario configurare le variabili d’ambiente nel file .env, che definisce i parametri di accesso alla casella email, le credenziali, i mittenti da monitorare e altre impostazioni relative al comportamento dell’app.
git clone https://github.com/LeonMusCoden/letterfeed.git
cd letterfeed
cp .env.example .env
Una volta copiato il file di esempio .env, è possibile modificarlo con i propri dati. Le variabili includono:
IMAP_HOST: indirizzo del server IMAPIMAP_PORT: porta (di default 993)IMAP_USERNAME e IMAP_PASSWORD: credenziali di accessoFEED_BASE_URL: URL base per la generazione dei feedSCAN_INTERVAL: frequenza di scansione della casella (in minuti)ALLOWED_SENDERS: elenco dei mittenti autorizzati
Dopo aver configurato il file .env, è sufficiente avviare i container con Docker Compose:
sudo docker-compose up -d
Al termine dell’installazione basta accedere da browser all’url http://localhost:3000/ il servizio inizierà a monitorare la casella email e a generare i feed RSS corrispondenti. Ogni newsletter ricevuta da un mittente autorizzato verrà convertita in un post leggibile, accessibile tramite un URL dedicato. L’interfaccia web consente di visualizzare lo stato del sistema, gestire i feed e monitorare l’attività. Possiamo anche aggiungere nuove caselle di posta e creare nuovi feed / email.
LetterFeed supporta anche la configurazione via interfaccia grafica per alcune impostazioni, ma le variabili definite nel file .env hanno priorità e non possono essere modificate dal pannello web. Questo garantisce coerenza e sicurezza, soprattutto in ambienti server.
