wlr-randr(1)

wlr-randr1

Utility to manage outputs of a wayland compositor

Usage

wlr-randr [options ...]

Overview

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.

Releases

4 releases since Debian 11 (Bullseye); the text changed 1 time.

  1. 11–13
  2. Arch

--above since Arch Linux 2026-11-01; --below since Arch Linux 2026-11-01; --json since Arch Linux 2026-11-01; --left-of since Arch Linux 2026-11-01; --right-of since Arch Linux 2026-11-01.

Authors

Maintained by Simon Ser <[email protected]>. For more information about wlr-randr development, see <https://gitlab.freedesktop.org/emersion/wlr-randr>.

From wlr-randr 0.5.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.