grim - Man Page
grab images from a Wayland compositor
Description
grim [options...] [output-file]
Synopsis
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.
Options
- -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.
- -o <output>
Set the output name to capture.
- -c
Include cursors in the screenshot.
Authors
Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open-source contributors. For more information about grim development, see https://github.com/emersion/grim.