.\" Generated by scdoc 1.11.4
.\" 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 "slurp" "1" "2026-04-09"
.PP
.SH NAME
.PP
slurp - select a region in a Wayland compositor
.PP
.SH SYNOPSIS
.PP
\fBslurp\fR [options.\&.\&.\&]
.PP
.SH DESCRIPTION
.PP
slurp is a command-line utility to select a region from Wayland compositors
which support the layer-shell protocol.\& It lets the user hold the pointer to
select, or click to cancel the selection.\&
.PP
If the standard input is not a TTY or the -r option is used, slurp will read a
list of predefined rectangles for quick selection.\& Each line must be in the form
"<x>,<y> <width>x<height> [label]".\& The label is optional and can be any string
that doesn'\&t contain newlines.\& It can be accessed using the "%l" sequence in a
format string.\&
.PP
If the \fIEsc\fR key is pressed, selection is cancelled.\& If the \fISpace\fR key is
held, the selection is moved instead of being resized.\&
.PP
.SH OPTIONS
.PP
\fB-h\fR
.RS 4
Show help message and quit.\&
.PP
.RE
\fB-d\fR
.RS 4
Display dimensions of selection.\&
.PP
.RE
\fB-b\fR \fIcolor\fR
.RS 4
Set background color.\& See \fBCOLORS\fR for more detail.\&
.PP
.RE
\fB-c\fR \fIcolor\fR
.RS 4
Set border color.\& See \fBCOLORS\fR for more detail.\&
.PP
.RE
\fB-s\fR \fIcolor\fR
.RS 4
Set selection color.\& See \fBCOLORS\fR for more detail.\&
.PP
.RE
\fB-B\fR \fIcolor\fR
.RS 4
Set color for highlighting predefined rectangles from standard input when not
selected.\&
.PP
.RE
\fB-F\fR \fIfont family\fR
.RS 4
Set the font family name when displaying the dimensions box.\& Only useful
when combined with the -d option.\& The available font family names guaranteed
to work are the standard generic CSS2 options: serif, sans-serif,
monospace, cursive and fantasy.\& It defaults to the sans-serif family name.\&
.PP
.RE
\fB-w\fR \fIweight\fR
.RS 4
Set border weight.\&
.PP
.RE
\fB-f\fR \fIformat\fR
.RS 4
Set format.\& See \fBFORMAT\fR for more detail.\&
.PP
.RE
\fB-p\fR
.RS 4
Select a single pixel instead of a rectangle.\& This mode ignores any
predefined rectangles read from the standard input.\&
.PP
.RE
\fB-o\fR
.RS 4
Add predefined rectangles for all outputs, as if provided on standard input.\&
The label will be the name of the output.\&
.PP
.RE
\fB-r\fR
.RS 4
Require the user to select one of the predefined rectangles.\& These can come
from standard input, if \fB-o\fR is used, the rectangles of all display outputs.\&
This option conflicts with \fB-p\fR.\&
.PP
.RE
\fB-a\fR \fIwidth\fR:\fIheight\fR
.RS 4
Force selections to have the given aspect ratio.\& This constraint is not
applied to the predefined rectangles specified using \fB-o\fR.\&
.PP
.RE
.SH COLORS
.PP
Colors may be specified in #RRGGBB or #RRGGBBAA format.\& The # is optional.\&
.PP
.SH FORMAT
.PP
Interpreted sequences are:
.PP
%x	The x-coordinate of the selection
.PP
%y	The y-coordinate of the selection
.PP
%w	The width of the selection
.PP
%h	The height of the selection
.PP
%X	The x-coordinate of the selection with coordinates relative to the output
.RS 4
containing the top left corner.\&
.PP
.RE
%Y	The y-coordinate of the selection with coordinates relative to the output
.RS 4
containing the top left corner.\&
.PP
.RE
%W	The width of the selection cropped to the output containing the top left
.RS 4
corner.\&
.PP
.RE
%H	The height of the selection cropped to the output containing the top left
.RS 4
corner.\&
.PP
.RE
%l	Label included with region from stdin
.PP
%o	The name of the output containing the top left corner, or "<unknown>" if
.RS 4
not known
.PP
.RE
The default format is "%x,%y %wx%h\en".\&
.PP
.SH KEYBOARD CONTROLS
.PP
The following keyboard actions can be used during selection:
.PP
\fBEscape\fR	Cancel the selection and exit slurp
.PP
\fBSpace\fR	 If currently making a selection, while space is held down, move the
entire selection rather than change the selection'\&s size as you move the
pointer.\&
.PP
\fBShift\fR	Experimental.\& If the \fB-a\fR option wasn'\&t specified, then set the aspect
ratio to 1:1 while shift is held down, releasing it restores the un-constrained
aspect ratio.\& \fBNote:\fR This behavior may change in the future depending on
feedback.\&
.PP
.PP
.SH AUTHORS
.PP
Maintained by Simon Ser <contact@emersion.\&fr>, who is assisted by other
open-source contributors.\& For more information about slurp development, see
https://github.\&com/emersion/slurp.\&