Repolode
Submit
LeonMusCoden

LeonMusCoden/LetterFeed

Self-hosted app that polls your email inbox over IMAP and turns newsletter emails into RSS feeds.

Open-source alternative to:Kill the Newsletter

View on GitHub
Stars
210
Forks
20
Open issues
7
Last commit
2 months ago

What is it?

LetterFeed is a self-hosted application that converts email newsletters into RSS feeds. It periodically connects to your mailbox over IMAP and checks for new messages from the senders you configure. Each new email is processed and added as an entry in the matching newsletter's RSS feed.

This lets you read newsletters that arrive only by email in any RSS reader, without keeping them in your inbox. Setup requires an IMAP mailbox reachable over SSL on port 993, along with Docker and Docker Compose. Mail account settings can be configured through environment variables or the web UI, while other options must be set through environment variables in the .env file.

The project is written in Python and deployed with Docker Compose.

Key features

  • 01Polls an IMAP mailbox over SSL for new emails from configured senders.
  • 02Adds each newsletter email as an entry in its own RSS feed.
  • 03Settings can be managed through environment variables or a web UI.
  • 04Deploys with Docker and Docker Compose.

Use cases

  • Reading email newsletters in an RSS reader alongside other feeds.
  • Keeping newsletters out of a crowded inbox while still reading them.
  • Self-hosting a newsletter-to-RSS bridge on a home server.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/LeonMusCoden/letterfeed.git
  2. 2

    Change into the project directory

    cd letterfeed
  3. 3

    Copy the example environment file and edit it with your IMAP settings

    cp .env.example .env
  4. 4

    Start the Docker containers

    docker compose up -d

Things to know

  • Requires an existing mailbox that supports IMAP over SSL on port 993.
  • Needs Docker and Docker Compose installed to run.

In collections

RSS readers and feed toolsSelf-hosted apps

Topics

#rss#email#imap#newsletter#self-hosted#docker#python

FAQ

What is LetterFeed?
Self-hosted app that polls your email inbox over IMAP and turns newsletter emails into RSS feeds. LetterFeed is a self-hosted application that converts email newsletters into RSS feeds. It periodically connects to your mailbox over IMAP and checks for new messages from the senders you configure. Each new email is processed and added as an entry in the matching newsletter's RSS feed.
Is LetterFeed free to use? What license does it have?
LetterFeed is open source under the MIT license. Check the license terms before using it in commercial products.
Is LetterFeed still maintained?
Updated within 6 months. The last commit to LetterFeed was on Sep 8, 2026.
What can I use LetterFeed for?
Reading email newsletters in an RSS reader alongside other feeds. Keeping newsletters out of a crowded inbox while still reading them. Self-hosting a newsletter-to-RSS bridge on a home server.
How do I install LetterFeed?
Clone the repository: git clone https://github.com/LeonMusCoden/letterfeed.git Change into the project directory: cd letterfeed Copy the example environment file and edit it with your IMAP settings: cp .env.example .env Start the Docker containers: docker compose up -d
Where can I get LetterFeed?
The source code and installation instructions are on GitHub: https://github.com/LeonMusCoden/LetterFeed

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects