User Guide

August 31, 2026 ยท View on GitHub

Quick Start

ActionResult
Left ClickOpen the widget popout
Middle ClickRegion capture
Right ClickPaste from clipboard
Drop ImageDrag an image onto the icon to annotate
PrintCapture using the default mode
  1. Trigger a capture from the bar icon, Control Center, or Print.
  2. 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.
  3. Annotate with the toolbar, shortcuts, or radial menus.
  4. 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

ShortcutTool
1Pen
2Line
3Arrow
4Rectangle
QEllipse
WText
EPixelate
RRedact
AStamp
SHighlighter
DFocus Spotlight
FColor Picker
TEraser
ZArea Zoom (Callout)
BBackground Options
IInsert Image
MToggle Watermark
OOCR Text Recognition
G (hold)Magnifier Lens
VSelect
XToggle annotations
TabToggle 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

InteractionResult
Right-click on canvasOpen eight customizable tool presets
Shift + right-click with Stamp activeStamp options
Shift + right-click with Text activeText options
Shift + right-click with Line activeLine 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

KeyAction
EnterDone; save or copy according to settings
EscDiscard and close
Ctrl + ZUndo
Ctrl + Y / Ctrl + Shift + ZRedo
Ctrl + SSave to file
Ctrl + CCopy to clipboard
Ctrl + Shift + CAnonymous copy
Ctrl + ACopy and save
Ctrl + FFloat image
Ctrl + XCrop or resize
+ / =Zoom in canvas
-Zoom out canvas
0Reset canvas zoom to 100%
[Decrease stroke size
]Increase stroke size
Ctrl + Shift + DragFree pan canvas
Ctrl + Shift + ScrollFocal zoom canvas centered at cursor
Ctrl + 1 to 4Select color slots 1 to 4
Ctrl + Q to RSelect 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
CommandArgumentsDescription
screenshotregion, full, all, output, window, last, or scroll; actionTrigger capture
selectFileactionOpen the file browser
fromClipboardactionAnnotate an image from the clipboard
openImagepath, actionOpen an image in the annotator
closenoneClose the annotator
showHistorynoneOpen recent edits

See the IPC and Settings Reference for the complete command and configuration reference.

Keybinding example