.\" Generated by scdoc 1.11.3
.\" 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" "2025-02-13"
.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>.\&