Skip to main content
otter-screenshot is Otter Shell’s Wayland screenshot tool. It captures through the ext_image_copy_capture_v1 protocol. No X11 fallbacks, no grim, no external 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 without 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

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.