Shortcuts¶

Pelton uses Cmd on macOS and Ctrl on Windows and Linux for the same bindings. The tables below write Cmd; substitute accordingly.

App¶

Shortcut	Action
`Cmd`+`N`	Compose a new message
`Cmd`+`K`	Command palette
`Cmd`+`F`	Search
`Cmd`+`R`	Sync now
`Cmd`+`M`	Add mailbox
`Cmd`+`,`	Settings
`Cmd`+`P`	Export open message as PDF
`Cmd`+`Z`	Undo the last send, delete or archive
`Ctrl`+`Cmd`+`F`	Toggle fullscreen
`Cmd`+`H`	Hide window (macOS)
`Cmd`+`W`	Close the front compose window, settings, or the window itself
`Cmd`+`Q`	Quit
`Backspace`	Delete the selected messages, or the open one

On Windows and Linux, where the in-app menu bar is the only menu there is, Alt on its own focuses the bar and underlines one letter in each menu title. Alt plus that letter opens the menu straight away. Arrow keys move between menus and items from there, Esc leaves.

The letters are worked out from the titles themselves, so they follow your language and any menu you have renamed or added. A binding you set under Settings, Shortcuts always wins over an access key using the same combination.

macOS has no such convention and does not use them.

Message actions¶

Delete is bound: Backspace, and Del does the same thing until you change the binding. It moves what you have selected to Trash, or the open message when nothing is selected, and Cmd+Z brings it back.

Reply, reply all, forward, mark read or unread, flag, snooze, archive and download-for-offline ship unbound so they cannot collide with anything. Bind them to whatever you like under Settings, Shortcuts. Each one acts on the messages you have selected, or on the open one when nothing is selected.

Whatever you bind shows up next to the matching entry when you right-click a message, and in the toolbar tooltips. Turn that off under Settings, Shortcuts with "Show keyboard shortcut hints in the app".

Reading tabs¶

Middle-click a message, or right-click it and pick Open in new tab, to park it in a tab. The tab bar only exists while a tab does.

Shortcut	Action
`Cmd`+`1`	Back to the reading pane
`Cmd`+`2` to `Cmd`+`8`	Jump to that tab
`Cmd`+`9`	Jump to the last tab
`Cmd`+`W`	Close the tab you are on

Middle-clicking a tab closes it too. With no tab open, Cmd+W closes the window as before.

Opening and closing a tab are also actions you can bind a key to under Settings, Shortcuts, and they sit in the View menu.

By default tabs last until you quit. Settings, Reading has a switch to bring them back next launch.

Developer overlays¶

Only in a development run, started with PELTON_DEV (what make run sets) or PELTON_DEVTOOLS=1. A normal build does not bind these keys at all.

Shortcut	Action
`F6`	Activity log: what the backend is doing, live
`F7`	Process: goroutines, heap, database and cache sizes
`F8`	Frames: frame timing for the ui

The overlays are draggable and several can be open at once. They always start closed.

The activity log shows the same lines Pelton writes to its log, so it follows the log level. Set PELTON_DEBUG=1 for the full sync detail.

The webview inspector is the browser's own, not Pelton's: F12 on Windows, Cmd+Alt+I on macOS, right-click and Inspect on Linux. It only exists in a development build.

Rebinding¶

Settings, Shortcuts lists every action with its current combo. Click one and press the new combination to rebind it, including the defaults above. If a combo is already taken, Pelton tells you what it is bound to.

Vim modes¶

Two independent toggles for keyboard-centric use:

App vim mode (Settings, Shortcuts): h/j/k/l style navigation across the message list and panes.
Compose vim mode (Settings, Composing): vim keybindings inside the compose editor.