Skip to content
Screenshots and screen sharing

Screenshots and screen sharing

Denial has a built-in region screenshot flow. External tools can capture whole outputs or single windows through ext-image-copy-capture-v1, and older tools can use version 3 of the wlr screencopy protocol. Desktop portals turn captured frames into PipeWire streams for browsers and sandboxed applications.

Built-in screenshots

Press Super+Shift+S to freeze the current desktop. The output under the pointer supplies the capture frame clock; drag over the area to capture anywhere on the desktop, or cancel with Escape or the right mouse button.

Denial writes a uniquely named PNG to:

  1. the directory in DENIAL_SCREENSHOT_DIR, when set; or
  2. ~/Pictures/Screenshots by default.

The PNG is also placed on the clipboard, ready to paste into applications that accept images. The selection canvas deliberately hides the software cursor. On the mobile shell, the Screenshot quick setting captures the full desktop without opening the region selector.

The shortcut can be changed or disabled in Settings → Shortcuts.

Screenshots with grim

Install the direct capture utilities if needed:

sudo pacman -S grim wf-recorder

Capture the desktop:

grim screenshot.png

Select an output by its connector name:

denialctl outputs
grim -o DP-1 screenshot.png

Capture a known region using logical coordinates:

grim -g "100,100 1280x720" region.png

Recording with wf-recorder

Record the screen until wf-recorder is stopped:

wf-recorder -f recording.mp4

Add desktop audio, select one output, or use an explicit region:

wf-recorder -a -f recording-with-audio.mp4
wf-recorder -o DP-1 -f recording.mp4
wf-recorder -g "100,100 1280x720" -f region.mp4

Browsers, OBS, and sandboxed applications

The Arch package installs portal routing that sends ScreenCast and Screenshot requests to xdg-desktop-portal-wlr; other desktop portal requests use the GTK backend. Denial configures a Zenity monitor chooser for it, which opens as a normal desktop window.

The complete path is:

application → desktop portal → xdg-desktop-portal-wlr → Denial image capture
            → PipeWire stream → application

If an application offers a system screen-sharing dialog, choose the monitor there. The compositor itself does not link PipeWire; the portal backend owns the stream.