.\" Generated by scdoc 1.8.0
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "grim" "1" "2019-02-10"
.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 a PNG file to \fIoutput-file\fR. If \fIoutput-file\fR is \fB-\fR, it will
output the file 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 filetype, valid values are \fBpng\fR or \fBjpeg\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.