Shortcuts¶

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

App¶

Menu bar access keys¶

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¶

Each one acts on the messages you have selected, or on the open one when nothing is selected.

These are the single letters webmail has used for years, so the keys you already know work here. They only fire when you are not typing: in a search box, an address field or the editor, the letter is just a letter.

Del deletes as well as Backspace, until you change that binding. Delete moves to Trash, and Cmd+Z brings it back.

Mark read, download-for-offline and unsubscribe ship unbound. Bind them to whatever you like under Settings, Shortcuts, which is also where you can change any of the keys above.

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.

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.

You do not have to remember the keys. In a development run the DEV badge in the status bar opens a menu listing each overlay, its key, and whether it is open. Clicking an entry toggles it.

Everything the overlays show is read on the machine and displayed there. Nothing is collected and nothing is sent anywhere.

The browser inspector is a separate thing and is not one of these. It is fixed when the binary is built, so make run has it and a downloaded Pelton does not, whatever environment variables are set.

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.

Need help?¶

See Support.