home | help
WLR-RANDR(1)		     General Commands Manual		    WLR-RANDR(1)

NAME
     wlr-randr - Utility to manage outputs of a Wayland compositor

SYNOPSIS
     wlr-randr [options...]

DESCRIPTION
     Command line interface which allows setting the size, scale, orientation of
     the  output for a screen. This utility requires the compositor to implement
     the wlr-output-management protocol.

OPTIONS
     --help
	 Show help message.

     --dryrun
	 Performs all the actions specified except that no changes are applied.

     --json
	 Print current state as JSON.

     --output <name>
	 Selects an output to reconfigure. This option must be set  when  making
	 making changes to the output using below options.

     --on
	 Enables the selected output.

     --off
	 Disables the selected output.

     --mode | --custom-mode <width>x<height>[@<refresh>Hz]
	 Set output resolution and, optionally, refresh rate.

     --pos <x>,<y>
	 Position the output with absolute layout coordinates.

     --left-of, --right-of, --above, --below <another-output>
	 Position  the output relative to an existing output. Absolute position-
	 ing via --pos overwrites a previously established relative position and
	 vice versa. The last positioning  option  passed  on  the  command-line
	 takes precedence.

     --transform normal|90|180|270|flipped|flipped-90|flipped-180|flipped-270
	 Transform the output by rotating it following the provided value.

     --scale <factor>
	 Scales  the  specified output by the specified scale factor. An integer
	 is recommended, but fractional values are also supported.  If	a  frac-
	 tional value are specified, be warned that it is not possible to faith-
	 fully represent the contents of your windows - they will be rendered at
	 the next highest integer scale factor and downscaled.

SEE ALSO
     xrandr(1)

AUTHORS
     Maintained  by  Simon Ser <contact@emersion.fr>. For more information about
     wlr-randr	development,  see  <https://gitlab.freedesktop.org/emersion/wlr-
     randr>.

				   2026-08-29			    WLR-RANDR(1)

home | help