.\" Generated by scdoc 1.11.5
.\" 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 "WLR\-RANDR" "1" "2026\-10\-30"
.PP
.SH NAME
.PP
wlr\-randr \- Utility to manage outputs of a Wayland compositor
.PP
.SH SYNOPSIS
.PP
\fBwlr\-randr\fR [options.\&.\&.\&]
.PP
.SH DESCRIPTION
.PP
Command line interface which allows setting the size, scale, orientation of the
output for a screen.\& This utility requires the compositor to implement the
\fBwlr\-output\-management\fR protocol.\&
.PP
.SH OPTIONS
.PP
\fB\-\-help\fR
.RS 4
Show help message.\&
.PP
.RE
\fB\-\-dryrun\fR
.RS 4
Performs all the actions specified except that no changes are applied.\&
.PP
.RE
\fB\-\-json\fR
.RS 4
Print current state as JSON.\&
.PP
.RE
\fB\-\-output\fR <name>
.RS 4
Selects an output to reconfigure.\& This option must be set when making
making changes to the output using below options.\&
.PP
.RE
\fB\-\-on\fR
.RS 4
Enables the selected output.\&
.PP
.RE
\fB\-\-off\fR
.RS 4
Disables the selected output.\&
.PP
.RE
\fB\-\-mode\fR | \fB\-\-custom\-mode\fR <width>x<height>[@<refresh>Hz]
.RS 4
Set output resolution and, optionally, refresh rate.\&
.PP
.RE
\fB\-\-pos\fR <x>,<y>
.RS 4
Position the output with absolute layout coordinates.\&
.PP
.RE
\fB\-\-left\-of\fR, \fB\-\-right\-of\fR, \fB\-\-above\fR, \fB\-\-below\fR <another\-output>
.RS 4
Position the output relative to an existing output.\& Absolute positioning
via \fB\-\-pos\fR overwrites a previously established relative position and
vice versa.\& The last positioning option passed on the command\-line takes
precedence.\&
.PP
.RE
\fB\-\-transform\fR normal|90|180|270|flipped|flipped\-90|flipped\-180|flipped\-270
.RS 4
Transform the output by rotating it following the provided value.\&
.PP
.RE
\fB\-\-scale\fR <factor>
.RS 4
Scales the specified output by the specified scale factor.\& An integer is
recommended, but fractional values are also supported.\& If a fractional
value are specified, be warned that it is not possible to faithfully
represent the contents of your windows \- they will be rendered at the
next highest integer scale factor and downscaled.\&
.PP
.RE
.SH SEE ALSO
.PP
\fIxrandr\fR(1)
.PP
.SH AUTHORS
.PP
Maintained by Simon Ser <contact@emersion.\&fr>.\& For more information about
wlr\-randr development, see <https://gitlab.\&freedesktop.\&org/emersion/wlr\-randr>.\&