.\" Generated by scdoc 1.11.0
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "grim" "1" "2020-07-22"
.P
.SH NAME
.P
grim - grab images from a Wayland compositor
.P
.SH DESCRIPTION
.P
\fBgrim\fR [options...] [output-file]
.P
.SH SYNOPSIS
.P
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.
.P
grim will write an image to \fIoutput-file\fR, or to a timestamped file name in
\fB$GRIM_DEFAULT_DIR\fR if not specified. If \fB$GRIM_DEFAULT_DIR\fR is not set, it
falls back first to \fB$XDG_PICTURES_DIR\fR and then to the current working
directory. If \fIoutput-file\fR is \fB-\fR, grim will write the image to the standard
output instead.
.P
.SH OPTIONS
.P
\fB-h\fR
.RS 4
Show help message and quit.
.P
.RE
\fB-s\fR <factor>
.RS 4
Set the output image's scale factor to \fIfactor\fR. By default, the scale
factor is set to the highest of all outputs.
.P
.RE
\fB-g\fR "<x>,<y> <width>x<height>"
.RS 4
Set the region to capture, in layout coordinates.
.P
If set to \fB-\fR, read the region from the standard input instead.
.P
.RE
\fB-t\fR <type>
.RS 4
Set the output image's file format to \fItype\fR. By default, the filetype
is set to \fBpng\fR, valid values are \fBpng\fR, \fBjpeg\fR or \fBppm\fR.
.P
.RE
\fB-q\fR <quality>
.RS 4
Set the output jpeg's filetype compression rate to \fIquality\fR. By default,
the jpeg quality is \fB80\fR, valid values are between 0-100.
.P
.RE
\fB-o\fR <output>
.RS 4
Set the output name to capture.
.P
.RE
\fB-c\fR
.RS 4
Include cursors in the screenshot.
.P
.RE
.SH AUTHORS
.P
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.