grim - Man Page

• Screenshot all outputs to the default path: grim
• Screenshot a specific output to the specified file: grim -o DP-1 path/to/output.png
• Select a specific region using slurp and screenshot it: grim -g "$(slurp)" path/to/output.png
• Screenshot and copy the image to the clipboard: grim - | clipboard_manager
• Set the output file type (default: png): grim -t png|ppm|jpeg path/to/output_file
• Set the PNG compression level (default: 6): grim -l 0-9 path/to/output.png
• Set the JPEG quality level (default: 80): grim -t jpeg -q 0-100 path/to/output.jpg
• Include cursors in the screenshot: grim -c

tldr.sh

grim [options...] [output-file]

grim is a command-line utility to take screenshots of Wayland desktops. For now it requires support for the screencopy protocol to work. Support for the xdg-output protocol is optional, but improves fractional scaling support.

grim will write an image to output-file, or to a timestamped file name in $GRIM_DEFAULT_DIR if not specified. If $GRIM_DEFAULT_DIR is not set, it falls back first to $XDG_PICTURES_DIR and then to the current working directory. If output-file is -, grim will write the image to the standard output instead.

-h

Show help message and quit.

-s <factor>

Set the output image's scale factor to factor. By default, the scale factor is set to the highest of all outputs.

-g "<x>,<y> <width>x<height>"

Set the region to capture, in layout coordinates.

If set to -, read the region from the standard input instead.

-t <type>

Set the output image's file format to type. By default, the filetype is set to png, valid values are png, jpeg or ppm.

-q <quality>

Set the output jpeg's filetype compression rate to quality. By default, the jpeg quality is 80, valid values are between 0-100.

-l <level>

Set the output PNG's filetype compression level to level. By default, the PNG compression level is 6 on a scale from 0 to 9. Level 9 gives the highest compression ratio, but may be slow; level 1 gives a lower compression ratio, but is faster. Level 0 does no compression at all, and produces very large files; it can be useful when grim is used in a pipeline with other commands.

-o <output>

Set the output name to capture.

-c

Include cursors in the screenshot.

-T <identifier>

Set the identifier of a foreign toplevel handle to capture.

Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open-source contributors. For more information about grim development, see <https://gitlab.freedesktop.org/emersion/grim>.

grimpicker(1), grimshot(1), xscreensaver(1).