Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
3ae77c6
Add a Settings button that makes Omamail the default mail client (#301)
huacnlee Sep 29, 2026
af8a7ae
Add a redesigned calendar and native Google integration (#300)
klaudworks Sep 30, 2026
afcd736
Fix attachment footer overflow in the message reader (#313)
huacnlee Sep 30, 2026
cd00721
Fix diagnostics redaction of static backend errors (#314)
huacnlee Sep 30, 2026
b3cf572
Fix Outlook token expiry after suspend (#317)
huacnlee Sep 30, 2026
b076196
Fix opening PDFs with embedded invoice XML (#312)
huacnlee Sep 30, 2026
59ae988
Prevent mailbox refresh failures under load (#315)
huacnlee Sep 30, 2026
ccb1e73
Fix reply recipients for sent messages (#309)
klaudworks Sep 30, 2026
ce2bac9
Add link and unsubscribe metadata to CLI reads (#310)
klaudworks Sep 30, 2026
7c73916
Fix mail syncing for personal Outlook accounts (#287)
Avdbergnmf Sep 30, 2026
31a5bb1
ai: Add Codex and OpenCode conversations with reviewed draft proposal…
klaudworks Oct 1, 2026
f32fb73
Clear draft recovery once every recovered message was sent (#319)
huacnlee Oct 1, 2026
a3b7616
Add a back button to AI history and open it directly from /history (#…
huacnlee Oct 1, 2026
2d5f2bd
Release v0.10.8 (#321)
huacnlee Oct 1, 2026
15270ba
Show calendar times in the system's 12- or 24-hour format
latentoperator Oct 1, 2026
f1feadd
Add local spelling state and personal dictionary storage
latentoperator Oct 1, 2026
87a4da5
Add spellchecking to the composer body
latentoperator Oct 1, 2026
49dc3dc
docs: Describe optional composer spelling dependencies
latentoperator Oct 1, 2026
20f39bd
Fix backend cancellation when the output pipe closes
latentoperator Oct 1, 2026
3c61921
Add bounded raw message export for Outlook and IMAP
latentoperator Oct 1, 2026
7369370
Add Save as .eml to message menus and keyboard actions
latentoperator Oct 1, 2026
b44073b
Add calendar times that follow the system time format
latentoperator Oct 2, 2026
7ad1f4c
Add composer spellchecking
latentoperator Oct 2, 2026
4e72c4e
Add Save as .eml for Outlook and IMAP messages
latentoperator Oct 2, 2026
51d8357
Update to upstream v0.10.8 with calendar time format, spellcheck, and…
latentoperator Oct 2, 2026
78407eb
Accept backend API 7 in the standalone app smoke check
latentoperator Oct 2, 2026
3a0a2e7
Merge the standalone API 7 smoke-check fix for Save as .eml
latentoperator Oct 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ jobs:
- run: cargo test --locked --no-default-features --features standalone --test platform_native
- run: cargo check --locked --all-targets --no-default-features --features standalone
- run: cargo test --locked --no-default-features --features standalone process
- run: cargo test --locked --no-default-features --features standalone --test cli agent_disabled_build_has_no_worker_or_agent_rpc
- run: cargo test --locked --no-default-features --test cli agent_disabled_build_has_no_worker_or_agent_rpc

standalone-app-macos:
name: Standalone app (macOS arm64)
Expand Down
600 changes: 44 additions & 556 deletions AGENTS.md

Large diffs are not rendered by default.

70 changes: 69 additions & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 4 additions & 2 deletions Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
[package]
name = "omamail"
version = "0.10.7"
version = "0.10.8"
edition = "2024"
publish = false

[features]
default = ["agent"]
agent = []
standalone = []
standalone = ["agent"]
integration-test-credentials = []

[dependencies]
Expand All @@ -32,6 +32,8 @@ base64 = "0.22"
chrono = { version = "0.4", default-features = false, features = ["std", "clock"] }
serde = { version = "1", features = ["derive"] }
serde_json = { version = "1", features = ["raw_value"] }
toml_edit = "0.25"
json5 = "0.4"
rustls-native-certs = "0.8"
zeroize = "1"

Expand Down
27 changes: 23 additions & 4 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
QMLLINT := /usr/lib/qt6/bin/qmllint
.DEFAULT_GOAL := test
QML_FILES := ui/Service.qml ui/BarWidget.qml ui/App.qml ui/compose/RecoveryController.qml \
ui/compose/SpellcheckAdapter.qml ui/compose/PersonalWords.qml \
ui/compose/SpellcheckAdapter.qml ui/compose/PersonalWords.qml ui/compose/SpellingState.qml \
ui/tests/compatibility/tst_published_agent.qml \
ui/tests/qml/tst_export_routing.qml ui/tests/qml/tst_message_menu_export.qml \
ui/backend/Backend.qml ui/backend/Runtime.qml ui/diagnostics/Diagnostics.qml \
ui/components/BackendSetup.qml ui/components/OmamailLogo.qml \
ui/account/MailAccount.qml ui/account/BackendSync.qml ui/account/SendQueue.qml ui/account/Intents.qml ui/account/BatchAction.qml ui/account/Rsvp.qml ui/account/LabelActions.qml ui/account/Unsubscribe.qml ui/account/NewMailNotification.qml \
Expand Down Expand Up @@ -63,18 +65,19 @@ QML_FILES := ui/Service.qml ui/BarWidget.qml ui/App.qml ui/compose/RecoveryContr
ui/components/AccountRemovalDialog.qml \
ui/components/ComposeExitDialog.qml \
ui/components/BackBar.qml \
ui/components/SettingsPage.qml \
ui/components/SettingsPage.qml ui/components/AiSettings.qml \
ui/components/SettingsSidebar.qml \
ui/components/CalendarSettings.qml \
ui/components/CalendarEventComposer.qml \
ui/components/CalendarEventDetail.qml \
ui/components/CalendarEventDetail.qml ui/components/CalendarReminderPanel.qml \
ui/components/CalendarPalette.qml \
ui/components/ConfirmDeleteDialog.qml \
ui/components/SetupPage.qml \
ui/components/ShortcutHelp.qml \
ui/calendar/CalendarController.qml ui/calendar/CalendarCache.qml \
ui/calendar/CalendarController.qml ui/calendar/CalendarCache.qml ui/calendar/CalendarReminders.qml ui/calendar/CalendarReminderInbox.qml \
ui/components/CalendarView.qml \
ui/components/WeekCalendarView.qml \
ui/components/WindowMoveArea.qml \
ui/bar/BarPreview.qml
APP_QML_FILES := app/qml/Main.qml app/qml/StandaloneShell.qml app/qml/StandaloneManifest.qml
APP_BUILD_DIR ?= app/build
Expand All @@ -99,6 +102,7 @@ test-local: test test-backend-process

test-backend-process:
cargo build --locked --target-dir "$(CURDIR)/target" --bin omamail
node ui/tests/test_backend_queue.js target/debug/omamail
python3 tests/test_backend_process.py
python3 tests/test_agent_native_bridge.py

Expand All @@ -116,14 +120,18 @@ test-js:
node app/tests/test_shell_theme.js
node ui/tests/test_bar_bridge.js
node ui/tests/test_backend_wire.js
node ui/tests/test_backend_queue.js
node ui/tests/test_backend_compatibility.js
node ui/tests/test_backend_runtime.js
node ui/tests/test_backend_chunks.js
node tests/test_imap_backend.js
node tests/test_hey_backend.js
node tests/test_gmail_backend.js
node ui/tests/test_settings.js
node ui/tests/test_spelling.js
node ui/tests/test_compose_recovery.js
node ui/tests/test_agent.js
node ui/tests/test_agent_options.js
node ui/tests/test_chat_text.js
node ui/tests/test_signature.js
node ui/tests/test_outbox.js
Expand All @@ -136,9 +144,11 @@ test-js:
node ui/tests/test_gmail_api.js
node ui/tests/test_message.js
node ui/tests/test_calendar.js
node ui/tests/test_calendar_time.js
node ui/tests/test_calendar_cache.js
node ui/tests/test_calendar_feed.js
node ui/tests/test_calendar_sources.js
node ui/tests/test_calendar_reminders.js
node ui/tests/test_calendar_palette.js
node ui/tests/test_bar_preview.js
node ui/tests/test_unsubscribe.js
Expand All @@ -159,6 +169,7 @@ test-js:
node ui/tests/test_aliases.js
node ui/tests/test_menu.js
node ui/tests/test_provider.js
node ui/tests/test_eml_export.js
node ui/tests/test_imap.js
node ui/tests/test_jmap.js
node ui/tests/test_jmap_threads.js
Expand All @@ -180,6 +191,7 @@ test-shell-portable:
sh tests/test_dev.sh
python3 tests/test_attachment_common.py
python3 tests/test_notification.py
python3 tests/test_calendar_notifications.py
python3 tests/test_curl_config.py
python3 tests/test_public_http.py
python3 tests/test_contacts.py
Expand All @@ -191,6 +203,7 @@ test-shell-portable:
bash tests/test_agent_job.sh
bash tests/test_link_plugin.sh
bash tests/test_mailto.sh
bash tests/test_default_mail.sh
bash tests/test_transport.sh
bash tests/test_jmap_transport.sh
python3 tests/test_jmap_stream.py
Expand Down Expand Up @@ -228,6 +241,12 @@ QMLTESTRUNNER := $(shell command -v qmltestrunner6 2>/dev/null \
|| ls /usr/lib/qt6/bin/qmltestrunner 2>/dev/null \
|| command -v qmltestrunner 2>/dev/null)

# Use the verified release download, not a build from this checkout.
.PHONY: test-agent-published
test-agent-published:
@test -n "$(PUBLISHED_BACKEND)" || { echo "Set PUBLISHED_BACKEND to the verified pinned executable" >&2; exit 1; }
python3 tests/test_agent_published_qml.py --binary "$(PUBLISHED_BACKEND)" --runner "$(QMLTESTRUNNER)"

test-qml:
@test -n "$(QMLTESTRUNNER)" || { \
echo "qmltestrunner not found: install Qt 6 QML test tooling" >&2; \
Expand Down
20 changes: 16 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
> **Public development copy of [Omamail](https://github.com/huacnlee/omamail), maintained by Chris Gray.** It adds spellchecking in the message composer and saving a message as an `.eml` file; both are merged on `main`. The installation instructions below install upstream Omamail; this copy has no published release.
> **Public development copy of [Omamail](https://github.com/huacnlee/omamail), maintained by Chris Gray.** Based on upstream v0.10.8, it adds composer spellchecking, Save as `.eml`, and calendar times that follow the system's 12/24-hour setting. The same three changes are offered upstream as [#323](https://github.com/huacnlee/omamail/pull/323), [#324](https://github.com/huacnlee/omamail/pull/324), and [#325](https://github.com/huacnlee/omamail/pull/325). The installation instructions below install upstream Omamail; this copy has no published release.

# Omamail

Expand Down Expand Up @@ -42,6 +42,12 @@ irm https://huacnlee.github.io/omamail/install.ps1 | iex

Each 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](docs/BACKEND-RUNTIME.md#standalone-bundled-backend) for package layout, platform integration, installer behavior, and security checks.

### Optional spelling support

Composer body spellchecking uses KDE Sonnet and a local Hunspell dictionary. On Arch, install `sonnet` and `hunspell-en_us`. On Debian and Ubuntu releases that provide Qt 6 Sonnet, install `qml6-module-org-kde-sonnet`, `sonnet6-plugins`, and `hunspell-en-us`. Restart Omamail after installing a dictionary.

Spelling checks default to US English and can be turned off in Settings. Without the Sonnet QML module or the selected dictionary, composing remains available and Settings explains what is missing. Omamail does not install system packages. Personal words are saved in Omamail's own `spelling.json`; Add to dictionary does not change a global Hunspell dictionary.

## Run from source

Install Rust, CMake 3.21 or newer, and Qt 6.5 or newer, then use the repository Make targets:
Expand All @@ -50,14 +56,14 @@ Install Rust, CMake 3.21 or newer, and Qt 6.5 or newer, then use the repository
make app-run
```

`make app-run` builds the standalone backend without the AI feature, builds the Qt host, and launches it from the source resources. See [Contributing](CONTRIBUTING.md) for validation commands.
`make 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](CONTRIBUTING.md) for validation commands.

## Features

- **Multiple mailboxes:** Gmail, Outlook, 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`/`k` to move, `r` to reply, `c` to compose, `/` to search and `?` for all shortcuts.
- **AI assistance in Omarchy:** ask about selected messages and review suggested drafts using your Omarchy AI setup. See [AI assistance](docs/AGENT.md).
- **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`, `/history` and `/diagnose` manage 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.

Expand All @@ -69,9 +75,15 @@ Choose a provider in Settings. Gmail needs a Google OAuth client; Outlook needs

See [mailbox setup](docs/MAILBOXES.md) for provider instructions and limitations, including Microsoft 365 and Proton Mail Bridge.

## Make Omamail the default mail client

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.

## Open the Omarchy plugin from the keyboard

Add this to `~/.config/hypr/bindings.lua`:
To use another key, add this to `~/.config/hypr/bindings.lua`:

```lua
o.bind("SUPER + SHIFT + G", "Omamail", "omarchy shell shell toggle omamail '{}'")
Expand Down
2 changes: 1 addition & 1 deletion app/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
cmake_minimum_required(VERSION 3.21)

project(omamail-app VERSION 0.10.7 LANGUAGES CXX)
project(omamail-app VERSION 0.10.8 LANGUAGES CXX)

if(WIN32)
enable_language(RC)
Expand Down
2 changes: 1 addition & 1 deletion app/qml/StandaloneShell.qml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ QtObject {
readonly property string calendarPalettePath: ""
readonly property string notificationError: String(host && host.notificationError || "")
readonly property var capabilities: ({
agent: false,
agent: !!host && !!host.capabilities && host.capabilities.agent === true,
tray: false,
mailto: false,
notifications: !!host && !!host.capabilities
Expand Down
41 changes: 36 additions & 5 deletions app/qml/imports/qs/Ui/Dropdown.qml
Original file line number Diff line number Diff line change
Expand Up @@ -67,14 +67,45 @@ Item {
palette.button: root.background
palette.highlight: root.accent
palette.window: root.background
font.family: root.fontFamily
font.pixelSize: Style.font.bodySmall
// One row per option at the shell's popup row height: the cursor row takes
// the hover fill, the chosen one a check, and neither is coloured with the
// accent.
delegate: QQC.ItemDelegate {
id: option
required property var modelData
width: combo.width
required property int index
width: combo.width - 2
height: root.popupRowHeight
text: String(modelData.label || "")
font.family: root.fontFamily
palette.text: root.foreground
palette.highlight: root.accent
leftPadding: Style.spacing.controlPaddingX
rightPadding: Style.spacing.controlPaddingX
highlighted: combo.highlightedIndex === index
contentItem: Row {
spacing: Style.space(6)
Text {
width: Style.space(12)
anchors.verticalCenter: parent.verticalCenter
text: option.index === combo.currentIndex ? "✓" : ""
color: root.foreground
font.family: root.fontFamily
font.pixelSize: Style.font.bodySmall
}
Text {
anchors.verticalCenter: parent.verticalCenter
width: option.availableWidth - Style.space(18)
text: String(option.modelData.label || "")
textFormat: Text.PlainText
elide: Text.ElideRight
color: root.foreground
font.family: root.fontFamily
font.pixelSize: Style.font.bodySmall
}
}
background: Rectangle {
color: option.highlighted || option.hovered
? Style.hoverFillFor(root.foreground, root.accent) : "transparent"
}
}
onActivated: function(index) {
if (index < 0 || index >= root.options.length) return
Expand Down
Loading
Loading