User Guide
August 31, 2026 ยท View on GitHub
Quick Start
| Action | Result |
|---|---|
| Left Click | Open the widget popout |
| Middle Click | Region capture |
| Right Click | Paste from clipboard |
| Drop Image | Drag an image onto the icon to annotate |
| Capture using the default mode |
- Trigger a capture from the bar icon, Control Center, or Print.
- Drag to select an area. Drag one of the four corner handles to resize the current selection. Hold Ctrl and drag with the left mouse button to move the current selection without resizing it.
- Annotate with the toolbar, shortcuts, or radial menus.
- Press Enter to finish or Esc to discard.
Scrolling Capture
Select a region, press Space or Enter to confirm, scroll the content, then press Enter to finish stitching. Adjust the scroll interval in settings.
Annotation Tools
Tool Selection
| Shortcut | Tool |
|---|---|
| 1 | Pen |
| 2 | Line |
| 3 | Arrow |
| 4 | Rectangle |
| Q | Ellipse |
| W | Text |
| E | Pixelate |
| R | Redact |
| A | Stamp |
| S | Highlighter |
| D | Focus Spotlight |
| F | Color Picker |
| T | Eraser |
| Z | Area Zoom (Callout) |
| B | Background Options |
| I | Insert Image |
| M | Toggle Watermark |
| O | OCR Text Recognition |
| G (hold) | Magnifier Lens |
| V | Select |
| X | Toggle annotations |
| Tab | Toggle Select and the last active tool |
Drawing and Editing
- Scroll the mouse wheel to adjust brush or font size.
- Middle-click an element to delete it.
- Select a vector with V, then press C to duplicate it.
- Press C without a selection to paste the last copied vector.
- Use Ctrl + Z and Ctrl + Y for undo and redo.
- Drag with Text to create a speech bubble; a single click creates normal text.
- Drag with Stamp to create a leader line; a single click creates a normal stamp.
Hold Shift while drawing to constrain shapes: Pen draws straight lines; Line, Arrow, and Highlighter snap to 15-degree increments; Ellipse makes a circle; Rectangle, Redact, and Pixelate make a square.
Crop Controls
- Hold Shift while creating a crop to constrain it to a 1:1 square. The same modifier works when resizing from a corner handle.
- Hold Ctrl and drag to move the current crop without changing its size. The drag can start anywhere on the canvas; corner and edge handles still resize the crop.
Popover Toolbars and Radial Menus
| Interaction | Result |
|---|---|
| Right-click on canvas | Open eight customizable tool presets |
| Shift + right-click with Stamp active | Stamp options |
| Shift + right-click with Text active | Text options |
| Shift + right-click with Line active | Line options |
Canvas Zoom and Pan
- Focal Zoom: Hold Ctrl + Shift and scroll the mouse wheel to zoom in or out centered at the cursor location.
- Keyboard Zoom: Press + or = to zoom in, - to zoom out, and 0 to reset zoom to 100%.
- Stroke Size: Press [ to decrease stroke size and ] to increase stroke size.
- Free Pan: Hold Ctrl + Shift and drag with the left mouse button to pan freely across the canvas.
- Directional Scroll: Hold Ctrl and scroll to pan vertically; hold Shift and scroll to pan horizontally.
Special Tools
- Hold G for the magnifier lens and scroll to adjust zoom from 1.5x to 4x.
- Press Z to draw a callout and scroll to adjust zoom from 100% to 500%.
Keyboard Shortcuts
| Key | Action |
|---|---|
| Enter | Done; save or copy according to settings |
| Esc | Discard and close |
| Ctrl + Z | Undo |
| Ctrl + Y / Ctrl + Shift + Z | Redo |
| Ctrl + S | Save to file |
| Ctrl + C | Copy to clipboard |
| Ctrl + Shift + C | Anonymous copy |
| Ctrl + A | Copy and save |
| Ctrl + F | Float image |
| Ctrl + X | Crop or resize |
| + / = | Zoom in canvas |
| - | Zoom out canvas |
| 0 | Reset canvas zoom to 100% |
| [ | Decrease stroke size |
| ] | Increase stroke size |
| Ctrl + Shift + Drag | Free pan canvas |
| Ctrl + Shift + Scroll | Focal zoom canvas centered at cursor |
| Ctrl + 1 to 4 | Select color slots 1 to 4 |
| Ctrl + Q to R | Select color slots 5 to 8 |
Pin to Desktop
- Press Ctrl + F to export and float the image.
- Left-click the floating image to continue editing.
- Right-click it to minimize it; hover the icon to restore it.
- Middle-click the floating image to close it.
IPC Commands
Commands that capture or open images accept edit or float as the action:
dms ipc call quickCapture <command> [arg] edit|float
dms ipc call quickCapture screenshot region edit
dms ipc call quickCapture screenshot region float
| Command | Arguments | Description |
|---|---|---|
screenshot | region, full, all, output, window, last, or scroll; action | Trigger capture |
selectFile | action | Open the file browser |
fromClipboard | action | Annotate an image from the clipboard |
openImage | path, action | Open an image in the annotator |
close | none | Close the annotator |
showHistory | none | Open recent edits |
See the IPC and Settings Reference for the complete command and configuration reference.
