gitwtfhub

wtf is email?

lemon-casino/email — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · ops devopsComplexity · 4/5Setup · moderate

TL;DR

A self-hosted web tool for managing many email accounts at once, with OAuth token refresh, automatic forwarding, and an API for programmatic mail access.

Mindmap

mindmap
  root((Email))
    What it does
      Multi-mailbox manager
      Web dashboard
      Auto forwarding
    Tech stack
      Python
      Flask
      Docker
    Use cases
      Manage many mailboxes
      Forward emails
      Refresh OAuth tokens
    Audience
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Manage many Outlook, Gmail, QQ, and other IMAP mailboxes from one web dashboard.

REASON 2

Automatically forward incoming emails to another address or a Telegram chat.

REASON 3

Keep OAuth tokens for many Outlook and Hotmail accounts refreshed automatically on a schedule.

REASON 4

Fetch mail programmatically through an API key instead of logging into the web interface.

What's in the stack?

PythonFlaskDockerSQLite

How it stacks up

lemon-casino/email1038lab/comfyui-agnes-aiandyuneducated/resolve-ai
Stars181818
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity4/52/54/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires OAuth credentials or API keys for the mail providers you want to connect, plus a fixed SECRET_KEY for production use.

Wtf does this do

This repository is a self-hosted email management tool built for people who juggle many mailboxes at once. It connects to accounts through Outlook and Hotmail's official login system and Microsoft's Graph API, falls back to standard IMAP when needed, and also works with regular providers like Gmail, QQ, 163, 126, Yahoo, and Alibaba Mail, plus custom IMAP servers. It additionally integrates several disposable, temporary email providers for generating throwaway addresses. The tool ships as a web application with a four column layout: a tree of folders for organizing accounts into groups, a list of mailboxes within the selected group, a list of messages in the chosen mailbox, and a detail pane for reading a selected message. Groups and individual accounts can each be routed through their own HTTP or SOCKS5 proxy. Accounts can be tagged, exported, moved between groups in bulk, and deleted individually or in bulk. Beyond reading mail, the tool can automatically forward incoming messages by account, either by email through SMTP or by pushing them to Telegram, with options to limit forwarding to a recent time window and to include or exclude junk mail. It also manages OAuth token refresh for Outlook and Hotmail accounts, supporting scheduled refresh on a cron style timer and bulk actions across many accounts at once. A separate WebDAV backup feature can automatically upload exported account and mailbox data on a schedule. For automation, the project exposes an external API that lets other programs fetch mail directly using an API key instead of logging in through the web interface, with support for alias addresses and combined folder views. You can run it by downloading a prebuilt Windows or macOS app, by pulling a Docker image, or by cloning the Python source and running it directly with pip. A password protected login screen guards the web interface, along with basic security measures like rate limiting and audit logging. The README notes the service should run as a single worker process, since some background tasks rely on short-lived state kept in memory.

Yoink these prompts

Prompt 1
How do I set up this email tool with Docker and connect my Outlook account?
Prompt 2
Explain how the automatic email forwarding and Telegram forwarding features work.
Prompt 3
Walk me through refreshing OAuth tokens for many Outlook accounts at once.
Prompt 4
How can I use the external API to fetch emails without logging into the web UI?

Frequently asked questions

wtf is email?

A self-hosted web tool for managing many email accounts at once, with OAuth token refresh, automatic forwarding, and an API for programmatic mail access.

What language is email written in?

Mainly Python. The stack also includes Python, Flask, Docker.

How hard is email to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is email for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.