Skip to main content

Keyboard Shortcuts

Complete reference for all keyboard shortcuts in mahpastes. Press ? at any time to open the built-in shortcut cheatsheet.

Keyboard shortcuts cheatsheet

macOS Menu Bar​

On macOS the menu bar mirrors the most common actions: File (Import Files with Cmd + O, Import Folder with Cmd + Shift + O, Settings with Cmd + ,), View (Archive, Folder Mode, Watch Folders, Serve, Share, Plugins, REST API, Maintenance) and Help (Keyboard Shortcuts, Documentation). A menu item runs the same action as its keyboard shortcut, and works from every view: from the Watch, Serve or Share view, Import Files, Import Folder, Archive and Folder Mode return to the clip gallery first, and Watch Folders and Serve switch to that view (or back to the gallery when it is already showing). An open menu drawer is closed first. Nothing happens while a dialog, the lightbox, the editor, the comparison view or the import wizard is in front. Windows and Linux have no menu bar and keep the shortcuts below.

System​

ShortcutAction
?Show keyboard shortcut cheatsheet
EscClose current modal, drawer, or cheatsheet
Cmd + VPaste from system clipboard
Cmd + CCopy (context-dependent, see below)
Cmd + QQuit mahpastes (desktop app; asks first when the editor has unsaved changes)

Cmd+C Behavior​

Cmd + C is context-dependent:

ContextAction
Lightbox openCopies clip contents (raw image or text) to clipboard
Clips selected in galleryCopies selected clips as files to system clipboard
Text selected / input focusedStandard browser copy (not intercepted)
ShortcutAction
/Focus search
AToggle archive view
FToggle folder mode
WOpen watch folders
,Open settings
POpen plugins
MOpen menu drawer
SOpen Serve View
ShortcutAction
NUpload / add clip
Cmd + ASelect all
Cmd + Shift + DeleteClear temp files
↑ ↓ ← →Navigate gallery grid

Clip Actions​

When a clip card has keyboard focus:

ShortcutAction
EnterOpen in lightbox
CCopy clip as file
DDelete clip
EArchive / unarchive
Cmd + DDownload clip
TTag clip
SpaceSelect / deselect
Cmd + EnterOpen context menu

Bulk Actions​

When clips are selected:

ShortcutAction
EscClear selection
CCopy selected as files
Cmd + CCopy selected as files
DDelete selected
EArchive selected
Cmd + DDownload selected
TTag selected
XSet expiration

When viewing a clip in the lightbox:

ShortcutAction
←Previous image
→Next image
+Zoom in
-Zoom out
EOpen editor
DDelete the clip on screen (asks first; the viewer stays open and moves to the next clip)
AArchive or restore the clip on screen and move to the next
TEdit tags
Cmd + EnterOpen the Actions menu
SpacePlay or pause a video
Cmd + CCopy clip contents
EscClose open menu first, then close lightbox
Tab / Shift + TabCycle focus within lightbox buttons (focus trap)

When a dropdown menu is open inside the lightbox:

ShortcutAction
↓ / ↑Navigate menu items
EscClose menu
TabClose menu

Comparison Modal​

When the image comparison modal is open:

ShortcutAction
1Fade mode
2Slider mode
3Diff mode
SSwap images
+Zoom in
-Zoom out
0Fit to viewport
←Adjust range left
→Adjust range right
EscClose comparison

Image Editor​

When the image editor is open:

ShortcutAction
BBrush tool
EEraser tool
LLine tool
WArrow tool
URectangle tool
OCircle tool
TText tool
IEyedropper tool
VSelect tool
XAnonymize tool
CCrop tool
RRotate 90° clockwise
Shift + RRotate 90° counter-clockwise
Cmd + ZUndo last action
Cmd + Shift + ZRedo undone action
Cmd + YRedo (alternative)
Cmd + ASelect all
Cmd + CCopy selection
Cmd + VPaste selection
DeleteDelete selection
EnterConfirm crop or active selection
Cmd + SSave (overwrite the clip)
Cmd + Shift + SSave As (create a new clip)
]Increase brush size
[Decrease brush size
}Increase opacity
{Decrease opacity
EscCancel active selection/crop, or close editor
Undo History

The image editor maintains up to 50 undo steps.

There is no default keyboard shortcut for the editor's in-place Save button.

Text Editor​

ShortcutAction
Cmd/Ctrl + Shift + PToggle Preview/Edit (every recognized text clip)
Cmd/Ctrl + FOpen Find / Replace
← / →Switch Preview/Edit when the mode tabs are focused
EscClose the editor; confirms before discarding changes

A custom binding for the old Markdown-only preview toggle migrates to the generalized Toggle Preview/Edit action automatically.

Text Placement (Editor)​

ShortcutAction
EnterConfirm text placement
EscCancel text placement

Drop Zone​

ShortcutAction
Enter or SpaceOpen file picker (when drop zone is focused)

Confirm Dialog​

ShortcutAction
Tab / Shift + TabCycle focus within dialog (focus trap)
EscClose dialog

Plugin Modals​

ShortcutAction
EscClose result modal first, then options modal, then plugins modal

Common Workflows​

Quick Workflow​

  1. Cmd + V to paste
  2. Click to view/edit
  3. Esc to close and continue

Image Annotation Flow​

  1. Open image editor
  2. Select a tool from the toolbar (Select, Crop, Brush, Eraser, Line, Arrow, Rectangle, Circle, Text, Anonymize, Eyedropper)
  3. Cmd + Z if you make a mistake
  4. Cmd + S to save as a new clip

Bulk Operations​

  1. Click checkboxes to select multiple clips
  2. Use the action bar for bulk archive/delete/download

Customization​

Customize shortcuts from Menu Drawer → Settings → Keyboard Shortcuts:

  1. Open the menu drawer with M (or click the menu button)
  2. Open Settings
  3. Scroll to Keyboard Shortcuts
  4. Click any shortcut key badge and press a new key combo
  5. Use Reset All to Defaults to revert all custom bindings

Keyboard shortcut settings

Global Shortcuts (Linux)​

The shortcuts above work while the mahpastes window has focus. mahpastes has no system-wide hotkey of its own, but on Linux its desktop entry (installed by make install) offers actions your desktop can bind to a global key:

  • Save Clipboard as Clip saves the current clipboard as a new clip, like pasting into the window.
  • Show mahpastes brings the window forward.

On KDE Plasma, open System Settings > Keyboard > Shortcuts, choose Add New > Application..., pick mahpastes and assign keys to its actions. On GNOME and other desktops, add a custom shortcut that runs ~/.local/bin/mahpastes --paste-clipboard (or just ~/.local/bin/mahpastes to show the window). See Save the Clipboard from a Global Shortcut for details.