Skip to the content.

⚡ Zero-copy GPU capture 👁️ Sees occluded windows 🖥️ Across workspaces 🦀 Rust · native Wayland 🎨 Themeable 🌍 13 languages

Five sharp tools. One capture engine.
Pick · switch · capture · inspect · draw.

Source on GitHub   Compatibility


wlr-draw — draw live on screen

Scribble over anything. Arrows, shapes, dwell-snap and text on a transparent always-on-top overlay — plus a presenter spotlight to focus the room.

Presenter spotlight — hold Shift to dim everything but a flashlight that follows the cursor, or pose a fixed spotlight on a window:

wlr-draw            # start the daemon
wlr-draw toggle     # toggle draw mode (bind it to a hotkey)

wlr-switcher — Alt-Tab & exposé with live previews

Alt-Tab with live previews. The exposé reveals windows from other workspaces — even occluded ones. Real moving thumbnails, not icons.

# A true Alt-Tab: bind it to a held modifier.
bindsym Mod1+Tab exec wlr-switcher

wlr-chooser — pick a window or screen

Share the right window. A rofi-like picker with live thumbnails for the screencast portal — pick from previews, not a text list.


wlr-shot — capture the screen

Screenshot or record anything. Region, window or whole output → PNG/JPEG, or H.264 / GIF with system audio and timelapse. Below: the frozen region selector.

wlr-shot screenshot -s out.png        # drag a region on a frozen screen
wlr-shot record -o DP-1 --audio out.mp4

wlr-peek — inspect the screen

Inspect the screen. Colour pipette, magnifier, live picture-in-picture mirror, OCR, visual grep and a change monitor — in one tool.

The live mirror (picture-in-picture, zooming a region ×2), and the CLI subcommands (ocr, watch, …) running against the screen:

wlr-peek color                          # pipette — pick a colour
wlr-peek loupe                          # magnifier — scroll to zoom
wlr-peek mirror -w ID                   # live picture-in-picture of a window
wlr-peek region                         # slurp replacement — print "X,Y WxH"
wlr-peek ocr -s                         # OCR a region you select
wlr-peek grep "feature"                 # visual grep — find on-screen text
wlr-peek watch -o DP-1 --on change      # fire when a region changes

Install

All five tools in one go — the wlr-utils bundle:

cargo install wlr-utils

…or grab the prebuilt bundle (one archive + a one-line wlr-utils-installer.sh). Prefer a single tool? Install it on its own — cargo install wlr-shot (also wlr-chooser, wlr-peek, wlr-draw). Uninstall with cargo uninstall <name>; see the main README for the leftover files wlr-draw writes (its autostart entry).

They run on wlroots compositors that implement ext-image-copy-capture-v1 (sway, Hyprland, niri, …). See the compatibility matrix.

All media on this page is generated reproducibly by tools/screenshots in an isolated headless compositor.