Skip to main content
otter-screenshot captures your Wayland screen through ext_image_copy_capture_v1. It does not fall back to X11, grim, or another capture tool. By default you drag to select a region and the result goes to the clipboard as image/png. Pass --output to write a file instead.

Basic usage

Run otter-screenshot with no arguments to enter region-selection mode. Drag with the left mouse button to define the area. Press Esc or Ctrl+C before selecting to cancel. otter-rec and otter-shot use the same drag-to-select UI for region capture.

Options

Annotation

--annotate freezes the screen, lets you select a region, then keeps that capture in place for editing. The pixels stay where they were. The desktop outside the selection goes live again. A toolbar sits above the rectangle when it fits, otherwise below it. Hover an icon for its name and shortcut. Tools cover selection, move, resize, arrows, spotlight, lines, freehand and highlighter strokes, rectangles, ellipses, numbered markers, mosaic or solid redaction, text, colors, widths, fill, undo, redo, and whole-image OCR. OCR copies recognized text to the clipboard. It uses the system tesseract CLI. Packaged installs depend on tesseract-ocr. If tesseract is missing, only the OCR button is disabled. Enter copies and saves. Toolbar buttons or Ctrl+C / Ctrl+S choose one output. otter-shot uses the same annotation tools after a capture.

Clipboard

When no --output path is given, otter-screenshot pipes the PNG through wl-copy --type image/png. Otter Shell ships its own wl-copy as part of the native data-control implementation, so you do not need a separate clipboard utility. File output writes directly to disk and does not touch the clipboard.

Compositor requirements

otter-screenshot requires the compositor to expose the ext_image_copy_capture_v1 protocol for output capture. If the compositor does not support it, the tool exits with an error. It does not fall back to another capture path.Active-window capture (--active) also requires ext_foreign_toplevel_list_v1 and ext_foreign_toplevel_image_capture_source_manager_v1. If either protocol is missing, --active will not work.

Binding a shortcut

Bind otter-screenshot to a hotkey in your compositor config. Examples:Hyprland:
Sway:
See Keybinds for more compositor examples.