1grim(1) General Commands Manual grim(1)
2
3
4
6 grim - grab images from a Wayland compositor
7
9 grim [options...] [output-file]
10
12 grim is a command-line utility to take screenshots of Wayland desktops.
13 For now it requires support for the screencopy protocol to work. Sup‐
14 port for the xdg-output protocol is optional, but improves fractional
15 scaling support.
16
17 grim will write an image to output-file, or to a timestamped file name
18 in $GRIM_DEFAULT_DIR if not specified. If $GRIM_DEFAULT_DIR is not set,
19 it defaults to $XDG_PICTURES_DIR. If output-file is -, grim will output
20 the image to the standard output instead.
21
23 -h
24 Show help message and quit.
25
26 -s <factor>
27 Set the output image's scale factor to factor. By default, the
28 scale factor is set to the highest of all outputs.
29
30 -g "<x>,<y> <width>x<height>"
31 Set the region to capture, in layout coordinates.
32
33 If set to -, read the region from the standard input instead.
34
35 -t <type>
36 Set the output image's file format to type. By default, the file‐
37 type is set to png, valid values are png, jpeg or ppm.
38
39 -q <quality>
40 Set the output jpeg's filetype compression rate to quality. By
41 default, the jpeg quality is 80, valid values are between 0-100.
42
43 -o <output>
44 Set the output name to capture.
45
46 -c
47 Include cursors in the screenshot.
48
50 Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other
51 open-source contributors. For more information about grim development,
52 see https://github.com/emersion/grim.
53
54
55
56 2020-03-08 grim(1)