Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
grim(1)			    General Commands Manual		       grim(1)

       grim - grab images from a Wayland compositor

       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.	Sup-
       port 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	work-
       ing directory. If output-file is	-, grim	will write the image to	the
       standard	output instead.

	   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 file-
	   type	is set to png, valid values are	png, jpeg or ppm.

       -q <quality>
	   Set the output jpeg's filetype compression rate to quality. By de-
	   fault, the jpeg quality is 80, valid	values are between 0-100.

       -o <output>
	   Set the output name to capture.

	   Include cursors in the screenshot.

       Maintained by Simon Ser <>, who is assisted by other
       open-source contributors. For more information about grim development,

				  2020-08-28			       grim(1)


Want to link to this manual page? Use this URL:

home | help