Keyboard shortcuts
Default shortcuts, the shortcut sets, and how to change any key.
In the tables below, mod is Cmd on macOS and Ctrl on Linux.
Shortcut sets
Airpost starts from a set of keys you may already know. Pick one in Preferences > Shortcuts > Shortcut set:
- Gmail (the default)
- Outlook
- Apple Mail
- Inbox by Gmail
To change a single shortcut, click it in Preferences > Shortcuts and press the new keys. Two keys pressed one after the other also work, like G then I. Your changes are saved in keymap.json in your profile, on top of the set. Edit in a file opens it, and Restore the set discards your changes.
Keys in every set
| Action | Keys |
|---|---|
| New message | mod+N |
| Send message (in the composer) | mod+Enter |
| Check for new mail | F5 |
| Preferences | mod+, |
| Snooze | Z |
| Remove from view | Backspace or Delete |
| Open selected conversation | Enter |
| Return to conversation list | Esc |
| Move to newer / older conversation | Up / Down |
| Print thread | mod+P |
| Undo / redo | mod+Z / mod+Shift+Z |
| Switch to account 1–9 | mod+1 … mod+9 |
Gmail set
| Action | Keys |
|---|---|
| Compose | C, D or mod+N |
| Search | / |
| Reply / reply all / forward | R / A / F |
| Reply, reply all or forward in a new window | Shift+R / Shift+A / Shift+F |
| Archive | E |
| Trash | # |
| Mark as spam | ! |
| Star | S |
| Mark as read / unread | Shift+I / Shift+U |
| Mark as important / not important | + or = / - |
| Remove from view (Gmail) | Y |
| Mute conversation | M |
| Change labels / move to folder | L / V |
| Snooze | Z or H |
| Next / previous conversation | J / K |
| Open conversation | Enter or O |
| Back to list | Esc or U |
| Next / previous message in thread | N / P |
| Expand / collapse all messages | ; / : |
| Select conversation | X |
| Select all / none / read / unread / starred / unstarred | * A / * N / * R / * U / * S / * T |
| Remove and show previous / next | ] or } / [ or { |
| Go to Inbox, Unread, Starred, Sent, Drafts, All mail | G I, G U, G S, G T, G D, G A |
| Go to Contacts / Tasks / a label | G C / G K / G L |
| Find in thread / next / previous | mod+F / mod+G / mod+Shift+G |
Outlook set
| Action | Keys |
|---|---|
| New message | mod+N or mod+Shift+M |
| Search | F3 or mod+E |
| Reply / reply all / forward | mod+R / mod+Shift+R / mod+F |
| Delete | mod+D |
| Mark as read / unread | Ctrl+Q / Ctrl+U |
| Star | Ctrl+Shift+G |
| Snooze | Z or Ctrl+H |
| Send | Alt+S |
| Go to Inbox / Sent | mod+Shift+L / mod+Shift+O |
| Find in thread | mod+Shift+F or F4 |
Apple Mail set
| Action | Keys |
|---|---|
| Reply / reply all / forward | mod+R / mod+Shift+R / mod+Shift+F |
| Archive | Cmd+Ctrl+A |
| Mark as spam | mod+Shift+J |
| Mark as unread | mod+Shift+U |
| Star | mod+Shift+L |
| Search | mod+Alt+F |
| Send | mod+Shift+D |
| Go to Inbox, Starred, Sent, Drafts, All mail | Cmd+Ctrl+1 … Cmd+Ctrl+5 |
Composer
| Action | Keys |
|---|---|
| Send | mod+Enter |
| Focus To / Cc / Bcc | mod+Shift+T / mod+Shift+C / mod+Shift+B |
| Bold / italic / underline | mod+B / mod+I / mod+U |
| Insert a link | mod+K |
| Numbered list / bulleted list / quote | mod+Shift+7 / mod+Shift+8 / mod+Shift+9 |
| Outdent / indent | mod+[ / mod+] |
| Attach a file | mod+Shift+A |
| Delete an empty draft | mod+Esc |
Windows and views
| Action | macOS | Linux |
|---|---|---|
| Go to Mail | Cmd+Alt+1 or Cmd+0 | Ctrl+Shift+1 or Ctrl+0 |
| Go to Calendar | Cmd+Alt+2 | Ctrl+Shift+2 |
| Full screen | Cmd+Ctrl+F | F11 |
Calendar shortcuts are on Calendar and contacts.
How shortcuts are resolved
Airpost builds the active keymap from three layers, in this order:
| Layer | Source | Effect |
|---|---|---|
| Base | Built-in keys for your platform | The keys in Keys in every set |
| Set | The set chosen in Preferences > Shortcuts | Replaces the base keys of each action it defines |
| Plugins | Keys that features and plugins add | Added on top, so a set can’t remove mod+Enter from Send |
Your own changes in keymap.json are layered on top of the set. The file maps an action to one key or a list of keys, in the same format as the built-in sets:
{
"core:archive-item": "e",
"navigation:go-to-inbox": ["g i", "mod+shift+i"]
}
Airpost watches the file, so edits take effect as soon as you save. If a key doesn’t do what you expect, check whether another action already uses it.
Keyboard-free equivalents
Most actions you trigger with a key are also CLI commands, which helps when you want to do the same thing to many threads at once:
| Key (Gmail set) | CLI |
|---|---|
E | airpost archive <thread-id> or airpost archive --query '...' |
# | airpost trash <thread-id> |
S | airpost star <thread-id> |
Shift+I / Shift+U | airpost mark-read / airpost mark-unread |
Z | airpost snooze <thread-id> --until tomorrow |
mod+Z | airpost undo (takes back the CLI’s own last change; --any for any client’s) |