OS Manuals

/usr/bin/grim

Grab images from a Wayland compositor

From grim 1.5.0-r5 (enterprise-packages), captured 2026-11-08 by running grim -help (exit 0). permalink

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

  -h              Show help message and quit.
  -s <factor>     Set the output image scale factor. Defaults to the
                  greatest output scale factor.
  -g <geometry>   Set the region to capture.
  -t png|ppm|jpeg Set the output filetype. Defaults to png.
  -q <quality>    Set the JPEG filetype quality 0-100. Defaults to 80.
  -l <level>      Set the PNG filetype compression level 0-9. Defaults to 6.
  -o <output>     Set the output name to capture.
  -T <identifier> Set the identifier of a foreign toplevel handle to capture.
  -c              Include cursors in the screenshot.
Options (9)
OptionDescriptionSource
-hShow help message and quit.help + man
-s factorSet the output image's scale factor to factor.help + man
-g geometrySet the region to capture, in layout coordinates.help + man
-q qualitySet the output jpeg's filetype compression rate to quality.help + man
-l levelSet the output PNG's filetype compression level to level.help + man
-o outputSet the output name to capture.help + man
-cInclude cursors in the screenshot.help + man
-t typeSet the output image's file format to type. (in the manual page but not in --help)man
-T identifierSet the identifier of a foreign toplevel handle to capture. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.