Skip to content
trafficflowhqPublic

About

Consent-first email on your existing IMAP mailboxes. Optional AI assistet screener with local or Cloud models. Full local Clients for MacOS, Windows, Linux + Arch and Omarchy integrationst. Android + iOS (coming soon) Apps. AGPL-3.0.

Topics

Resources

Contributing

Security policy

Stars

95 stars

Watchers

1 watching

Forks

Latest commit

 

History

6,568 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ohmail

GitHub stars Total downloads across all releases Latest release License: AGPL-3.0 Platforms: macOS, Windows, Linux and Android

oh. consent-first email on your own mailboxes.

Mail that sorts itself into real IMAP folders. New senders wait at the Screener. Decide once, and ohmail files the rest.

or try the demo in your browser · ohmail.app, the hosted instance

Choose a face
paper, the face shownohmarchy: open this README in the ohmarchy face

ohmail on the desktop with a conversation open and its read squares: the paper face left of the seam, the ohmarchy face right of it
paper on the left, ohmarchy on the right: two faces of one app

Features

The Screener

People who write to you for the first time wait here until you decide once, for that address or the whole domain. Anyone you wrote to first goes straight in. Optionally, a model helps: it is asked about new senders as their mail arrives, in the cloud or on your own machine, and can file the ones it is sure about. Both are off until you switch them on.

The Screener with seven first-time senders waiting and the door buttons for Ohbox, News, Receipts, Screen out and Spam; pressing o, c and n files three of them and the count drops to four

News and Receipts

Newsletters get their own list with a line where you stopped. Orders, tickets and invoices get theirs, out of the Ohbox.

The News list with four new letters since the last visit, and the Receipts list beside it

Conversations, read as you see them

A conversation is one row in the Ohbox, your inbox. Open it and its unread messages sit on a tinted panel, with one square per message beside them that settles once you have actually seen it.

A five-message conversation opened from the Ohbox, its two unread messages on tinted panels and the square column beside them

Search your whole mailbox

Search answers as you type, forgives typos, covers your whole mailbox and says how long it took.

A misspelled search listing the closest matches, with the line that says the whole mailbox was searched and how many milliseconds it took

Keyboard first

Every verb has a key: j and k to move, e to park, a to answer later, z to undo, g and a letter to jump, and ? shows the whole sheet.

Moving through the Ohbox with j and k, parking a message with e, undoing it with z, then the keyboard shortcut sheet opened with ?

Your mailbox stays the source of truth

Filing is a real IMAP move into a few plain folders, and your rules are stored in the mailbox itself. Any other mail app sees the result, and nothing is lost if you leave.

How it works → · Format →

The setup step that names the folders ohmail creates inside the mailbox and says every other mail client sees them too

On your phone

The Android app organizes one mailbox on its own, or keeps a copy of a mailbox your desktop, ohmail.app or your own server organizes.

Android APK

Two Android screens: a first-time sender in the Screener with the door buttons, and a conversation with its unread message on a tinted panel and the square rail

Run it yourself

Run the whole stack on your own box with Docker Compose and pair your phone from Settings → Devices. Or switch on Devices in the desktop app, and it becomes the server for your phone over Tailscale.

Self-hosting →

Settings → Devices on a self-hosted server showing the code a phone scans to pair

Also in the box:

  • Rules you can read: every decision is a rule under Settings → Rules that you can change or revoke, and moving a message yourself teaches the rule that filed it.
  • AI only if you want it: your own Anthropic, OpenAI or OpenCode Go key, or a local model through Ollama, suggests where a sender's mail goes and drafts a reply. The AI files nothing for you unless you switch that on, and one-time codes are stripped before a model sees the mail.
  • Impersonations go to Spam: a waiting letter that presents itself as a company it can't be from goes to Spam on its own, without AI and without a rule, and stays in ohmail's own Spam. The Screener lists each one with its reason and Put back, letters with a code in them stay where you see them, and you can switch it off.
  • Answer Later, Park and Resurface: queue the mail you owe a reply and answer it one at a time in the Reply Run, or put mail away until the day it should come back.
  • History: every message you own, newest first, with the months and years on the side to jump anywhere.
  • Spam goes to your provider's own Junk folder. ohmail deletes nothing on its own.
  • Lists: screening a list out sends its one-click unsubscribe once the sender is confirmed.
  • Calendar invites as an event card, Send later, Send + Done, and one Undo (z) for every filing verb.
  • Pictures on your terms: pictures are fetched by your own device, and a tracking pixel the blocker recognises is never requested.
  • Your system's mail app: ohmail can be your default mail app, so an email link opens a new message, already filled in.
  • English and German, throughout. The changelog is the full list.

Two faces: paper and ohmarchy

One app, two faces. paper is the default everywhere but Linux: light, soft corners, shadow instead of line. ohmarchy is for people who live in a tiling window manager, after Omarchy: hard corners, drawn borders, mono type, panes with real gaps. Same features, same keys; only the tokens change. On Linux the app starts in ohmarchy, on Omarchy the desktop app follows your theme as you switch it, and an Omarchy plugin puts your unread count in the bar. Your own choice wins, under Settings → General → Look. This README has a twin in the other face; the switch at the top flips every screenshot below the header, and not one sentence.


Works with your mailbox

Gmail · iCloud · Fastmail · Microsoft 365* · any IMAP server

Gmail connects with an app password. * Microsoft 365 connects with your Microsoft sign-in on ohmail Cloud and on self-hosted servers set up for it; on the desktop, through a local mail gateway.

Install

Desktop: macOS, Windows, Linux

Platform Download
macOS (Apple silicon and Intel) ohmail.dmg
Windows (x86_64) ohmail-windows-setup.exe
Linux (x86_64) AppImage · .deb · .rpm
Linux (arm64) AppImage · .deb · .rpm

All builds and checksums. The builds are not code-signed yet, so the first launch on macOS and Windows needs one manual approval: what to press.

chmod +x ohmail-linux-x86_64.AppImage && ./ohmail-linux-x86_64.AppImage   # AppImage
sudo apt install ./ohmail-linux-amd64.deb                                 # Debian, Ubuntu
sudo dnf install ./ohmail-linux-x86_64.rpm                                # Fedora

Phone: Android

ohmail-android.apk. The phone can organize one mailbox on its own, or pair with the desktop app, ohmail.app or your own server and keep a copy.

Run the server yourself

git clone https://github.com/trafficflowhq/ohmail.git
cd ohmail/deploy/selfhost
cp .env.example .env      # fill in the required values; the file explains each
docker compose up -d
docker compose logs api   # prints the one-time setup token

On a server with a public domain, also set OHMAIL_BIND=0.0.0.0 in .env. Prebuilt images for amd64 and arm64; the self-hosting guide takes you from an empty VPS to backups.

Hosted

ohmail.app runs the same server source.

How ohmail organizes inside your mailbox

The folders ohmail creates are a small, frozen set:

Inbox                    mail from people you've said yes to
Junk                     your provider's own — your spam verdicts file into it
Sent                     your replies, left where your provider already keeps them
ohmail/
├── Screener             new senders wait here until you decide where they go
├── News                 newsletters and things you read when you have a minute
├── Receipts             receipts, confirmations, orders
├── Screened             senders you keep, but out of the Inbox
├── Quarantine           spam the automatic patterns set aside, held for review
└── _meta                a small bookkeeping folder; some mail apps show it

There is no folder called "Spam": "Spam" is only a label the app shows. The desktop app, ohmail Cloud and a server you run share no database, so what travels between them is the mailbox: your mail in these folders, and your settings (the senders you've screened in, your rules and which ones you removed, notification choices, away reply, signature and tag names) as one small versioned-JSON message in ohmail/_meta, in a published format. Connect the same mailbox from another of them and ohmail finds those settings and asks before using them. Triage piles, Resurface timers, learned patterns, notes and snippets stay where they were made. How it works →

Privacy

There is no telemetry and no analytics in the apps. ohmail Cloud keeps one record of its own about connecting a mailbox (ohmail.app/privacy); a self-hosted server and the desktop app keep none. In local mode on the desktop, only these leave the machine: the connections to your mail server, the signed update check, pictures in a message you open, one-click unsubscribes, lookups of the keys senders sign mail with, and, if you turn it on, requests to your model provider. Where your mail is, and what the app talks to →

Community & support

Developing

Read CONTRIBUTING.md first: every change is a pull request with a DCO sign-off (git commit -s) and a changelog.d/ entry. apps/webapp is the client, apps/desktop the desktop shell, apps/mobile the phone app, apps/sidecar the desktop's mail engine, packages/core the organizer, deploy/selfhost the server stack. Build from source.

License

AGPL-3.0 for the whole program: desktop, phone, web and server. The name and the icon are covered by TRADEMARK.md.

About

Consent-first email on your existing IMAP mailboxes. Optional AI assistet screener with local or Cloud models. Full local Clients for MacOS, Windows, Linux + Arch and Omarchy integrationst. Android + iOS (coming soon) Apps. AGPL-3.0.

Topics

Resources

Contributing

Security policy

Stars

95 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages