Airpost
Using Airpost

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

ActionKeys
New messagemod+N
Send message (in the composer)mod+Enter
Check for new mailF5
Preferencesmod+,
SnoozeZ
Remove from viewBackspace or Delete
Open selected conversationEnter
Return to conversation listEsc
Move to newer / older conversationUp / Down
Print threadmod+P
Undo / redomod+Z / mod+Shift+Z
Switch to account 1–9mod+1 … mod+9

Gmail set

ActionKeys
ComposeC, D or mod+N
Search/
Reply / reply all / forwardR / A / F
Reply, reply all or forward in a new windowShift+R / Shift+A / Shift+F
ArchiveE
Trash#
Mark as spam!
StarS
Mark as read / unreadShift+I / Shift+U
Mark as important / not important+ or = / -
Remove from view (Gmail)Y
Mute conversationM
Change labels / move to folderL / V
SnoozeZ or H
Next / previous conversationJ / K
Open conversationEnter or O
Back to listEsc or U
Next / previous message in threadN / P
Expand / collapse all messages; / :
Select conversationX
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 mailG I, G U, G S, G T, G D, G A
Go to Contacts / Tasks / a labelG C / G K / G L
Find in thread / next / previousmod+F / mod+G / mod+Shift+G

Outlook set

ActionKeys
New messagemod+N or mod+Shift+M
SearchF3 or mod+E
Reply / reply all / forwardmod+R / mod+Shift+R / mod+F
Deletemod+D
Mark as read / unreadCtrl+Q / Ctrl+U
StarCtrl+Shift+G
SnoozeZ or Ctrl+H
SendAlt+S
Go to Inbox / Sentmod+Shift+L / mod+Shift+O
Find in threadmod+Shift+F or F4

Apple Mail set

ActionKeys
Reply / reply all / forwardmod+R / mod+Shift+R / mod+Shift+F
ArchiveCmd+Ctrl+A
Mark as spammod+Shift+J
Mark as unreadmod+Shift+U
Starmod+Shift+L
Searchmod+Alt+F
Sendmod+Shift+D
Go to Inbox, Starred, Sent, Drafts, All mailCmd+Ctrl+1 … Cmd+Ctrl+5

Composer

ActionKeys
Sendmod+Enter
Focus To / Cc / Bccmod+Shift+T / mod+Shift+C / mod+Shift+B
Bold / italic / underlinemod+B / mod+I / mod+U
Insert a linkmod+K
Numbered list / bulleted list / quotemod+Shift+7 / mod+Shift+8 / mod+Shift+9
Outdent / indentmod+[ / mod+]
Attach a filemod+Shift+A
Delete an empty draftmod+Esc

Windows and views

ActionmacOSLinux
Go to MailCmd+Alt+1 or Cmd+0Ctrl+Shift+1 or Ctrl+0
Go to CalendarCmd+Alt+2Ctrl+Shift+2
Full screenCmd+Ctrl+FF11

Calendar shortcuts are on Calendar and contacts.

How shortcuts are resolved

Airpost builds the active keymap from three layers, in this order:

LayerSourceEffect
BaseBuilt-in keys for your platformThe keys in Keys in every set
SetThe set chosen in Preferences > ShortcutsReplaces the base keys of each action it defines
PluginsKeys that features and plugins addAdded 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:

keymap.json
{
  "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
Eairpost archive <thread-id> or airpost archive --query '...'
#airpost trash <thread-id>
Sairpost star <thread-id>
Shift+I / Shift+Uairpost mark-read / airpost mark-unread
Zairpost snooze <thread-id> --until tomorrow
mod+Zairpost undo (takes back the CLI’s own last change; --any for any client’s)