Omamail is a native email and calendar app with multiple accounts and keyboard navigation. It runs either as an Omarchy shell plugin or as a standalone Qt desktop application.
The plugin requires Omarchy 4 and follows the active Omarchy theme. It includes the bar widget, mailto: integration, and AI assistance through the configured Omarchy agent.
omarchy plugin add https://github.com/huacnlee/omamail.git --enableUpdate it with:
omarchy plugin update omamailClick the envelope in the bar, install the pinned backend when prompted, and add your mailbox. Prebuilt plugin backends are available for Linux x86_64 and aarch64.
The standalone app includes mail, calendar, and native desktop notifications. It has no system tray, AI assistance, or operating-system mailto: registration in this release.
macOS & Linux:
curl -fsSL https://huacnlee.github.io/omamail/install.sh | shWindows (PowerShell):
irm https://huacnlee.github.io/omamail/install.ps1 | iexEach installer verifies the release package before replacing an existing version. The macOS app and Windows executable are unsigned. The macOS installer removes quarantine only after verifying the downloaded archive. See standalone runtime and release details for package layout, platform integration, installer behavior, and security checks.
Composer body spellchecking uses KDE Sonnet and a local Hunspell dictionary. On Arch, install sonnet and the matching hunspell-<language> package, such as hunspell-en_us or hunspell-de. On Debian and Ubuntu releases that provide Qt 6 Sonnet, install qml6-module-org-kde-sonnet, sonnet6-plugins, and the matching dictionary, such as hunspell-en-us. Restart Omamail after installing a dictionary.
Only completed words in the message body are checked, not the subject or quoted reply lines whose first non-space character is >. Checking is limited to the visible viewport plus one viewport of context on each side, with a 20,000-character window, at most 400 visible underline segments, and 8 ms / 12-token work slices. Tokens longer than 128 UTF-16 units are skipped; lines indented by more than 128 spaces or tabs are conservatively skipped. Scrolling checks the newly visible text. Corrections remain available on demand without waiting for the underline pass. Spelling is off by default; turn it on in Settings. It uses the system language (Qt.locale().name, for example en_US or de_DE). The advanced spellingLanguage setting is empty for system language, or an installed dictionary code to override it; malformed values are treated as system language and never passed to Sonnet. There is no silent fallback to English: without the Sonnet QML module or the requested dictionary, composing remains available and Settings names what is missing. Omamail does not install system packages. Checks and corrections stay local; nothing leaves the machine. Ignore for this session stays in memory. Add to dictionary saves the word in Omamail's own spelling.json; it does not change a global Hunspell dictionary.
Install Rust, CMake 3.21 or newer, and Qt 6.5 or newer, then use the repository Make targets:
make app-runmake app-run builds the standalone backend and Qt host, then launches from the source resources. Current source builds enable AI assistance on Linux and macOS with an installed Claude, Codex or OpenCode CLI; choose the agent in Settings. Windows AI support remains deferred. See Contributing for validation commands.
- Multiple mailboxes: Gmail, Outlook, Microsoft 365, HEY, JMAP and IMAP/SMTP, including Fastmail, iCloud and self-hosted servers.
- Mail and calendar: read, search, compose, manage attachments and respond to meeting invitations. Available actions depend on your provider.
- Keyboard navigation:
j/kto move,rto reply,cto compose,/to search and?for all shortcuts. - AI assistance in Omarchy: ask about selected messages and review suggested drafts with Claude, OpenCode V2 or Codex. Follow your Omarchy default, or select an agent and optional model in Settings. An unsupported system default disables the AI action with a setup explanation. Conversations retain follow-ups and draft proposals;
/clear,/historyand/diagnosemanage the chat. - Desktop integration: native notifications and a compact layout for smaller windows; the Omarchy plugin also provides the bar widget and
mailto:integration. - Privacy controls: credentials stored in the system keyring and remote images blocked until you choose to load them.
Choose a provider in Settings. Released builds of Gmail sign in with an included Google OAuth client, and you can use your own instead; Outlook and Microsoft 365 need a Microsoft app registration. HEY uses the official HEY CLI. JMAP and IMAP usually use an app password or API token.
See mailbox setup for provider instructions and limitations, including Microsoft 365 and Proton Mail Bridge.
Omarchy opens HEY's web app on SUPER+SHIFT+E. Choose Settings → Default mail client → Set as default to make Omamail open mailto: links, SUPER+SHIFT+E, and SUPER+SHIFT+ALT+E for a new message.
The key bindings go in a clearly marked block in ~/.config/hypr/bindings.lua; Omarchy's own files are never changed. Undo removes the block and leaves the file as it was.
To use another key, add this to ~/.config/hypr/bindings.lua:
o.bind("SUPER + SHIFT + G", "Omamail", "omarchy shell shell toggle omamail '{}'")Press ? in Omamail for the shortcut sheet, or see the keyboard guide.
Omamail is an independent project and is not affiliated with Google, Microsoft or 37signals. Gmail, Outlook and HEY belong to their respective trademark owners.
Licensed under the MIT License.



