Skip to main content
Version: 1.4

Screenshot

███████╗ ██████╗██████╗ ███████╗███████╗███╗   ██╗
██╔════╝██╔════╝██╔══██╗██╔════╝██╔════╝████╗  ██║
███████╗██║     ██████╔╝█████╗  █████╗  ██╔██╗ ██║
╚════██║██║     ██╔══██╗██╔══╝  ██╔══╝  ██║╚██╗██║
███████║╚██████╗██║  ██║███████╗███████╗██║ ╚████║
╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═══╝

The dms screenshot command captures screenshots from Wayland displays with support for multiple capture modes, output formats, and clipboard integration.

Quick Start​

# Region select, save file + clipboard
dms screenshot

# Full screen of focused output
dms screenshot full

# Clipboard only
dms screenshot --no-file

Press Escape to cancel region selection at any time.

Capture Modes​

ModeCommandDescriptionregiondms screenshotSelect a region interactively (default)fulldms screenshot fullCapture the focused outputalldms screenshot allCapture all outputs combinedoutputdms screenshot output -o NAMECapture a specific output by namelastdms screenshot lastCapture the last selected region

List Available Outputs​

dms screenshot list

Output Formats​

Use --format or -f to specify the output format. Default is png.

FormatFlagNotesPNG-f pngDefault, losslessJPEG-f jpgUse -q to set quality (1-100)PPM-f ppmRaw format 
# JPEG with custom quality
dms screenshot -f jpg -q 85

Options​

FlagShortDescription--cursorInclude cursor in screenshot: on/off (default: off)--stdoutOutput to stdout (for piping)--dir-dOutput directory--filenameOutput filename (auto-generated if empty)--format-fOutput format: png, jpg, ppm (default: png)--quality-qJPEG quality 1-100 (default: 90)--output-oOutput name for 'output' mode--no-clipboardDon't copy to clipboard--no-fileDon't save to file--no-notifyDon't show notification--config-cCustom DMS config directory path--help-hShow help

Examples​

Region Selection​

# Interactive selection, save file + clipboard
dms screenshot

# File only, no clipboard
dms screenshot --no-clipboard

# Clipboard only, no file
dms screenshot --no-file

Full Screen Capture​

# Focused output
dms screenshot full

# All outputs combined
dms screenshot all

# Specific output
dms screenshot output -o DP-1

Repeat Last Capture​

# Capture the same region as before
dms screenshot last

Include Cursor​

dms screenshot full --cursor on

Pipe to Editor​

# Send to swappy for annotation
dms screenshot --stdout | swappy -f -

Custom Output Location​

# Save to specific directory
dms screenshot -d ~/Pictures/screenshots

# Custom filename
dms screenshot --filename my-screenshot.png