.\" 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>.\&