MERDE-SCREENSHOT(1) General Commands Manual MERDE-SCREENSHOT(1)

merde-screenshotcapture a MERDE output as PNG

merde-screenshot [path] [output=primary] [region=widthxheight+x+y]

merde-screenshot captures the primary NeuSWC output, including the cursor, and writes a PNG. If path is omitted, it writes a UTC timestamped name below MERDE_SCREENSHOT_DIRECTORY when set, or below MERDE_RUNTIME_DIR otherwise. Unnamed screenshots are created privately and never replace an existing file. The written path is printed on standard output, appended to the session screenshot log, and sent to the notifier when one is available.

The optional region is measured from the top-left corner and must lie entirely inside the primary output. Only output=primary is currently supported.

Unnamed screenshots use the private session runtime directory and are disposable session output. Users who want retained screenshots can set MERDE_SCREENSHOT_DIRECTORY or configure the screenshots companion directory.

Selects the Wayland display.
Selects the default output directory.
Selects the private default output directory and locates the session screenshot log and notification FIFO.
Overrides the notification FIFO path.

The program exits 0 after writing the PNG, 2 for invalid arguments, and 1 for capture or output errors.

merde(1), merde-notify(1), merdectl(1)

MOUSE August 17, 2026 MERDE-SCREENSHOT(1)