grim(1)

NAME

grim - 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 a PNG file to output-file. If output-file is -, it will output the file 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 filetype, valid values are png or jpeg.

-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.