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
           positioning 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 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.

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>.

                                  2025-02-13                      WLR-RANDR(1)