WLR-RANDR(1) General Commands Manual WLR-RANDR(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

**wlr-randr** \[options...]

# [DESCRIPTION](#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](#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](#SEE_ALSO)

[*xrandr*(1)](/man/enterprise-packages/wlr-randr/xrandr.1)

# [AUTHORS](#AUTHORS)

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

2026-10-30

---

Document: wlr-randr(1) from wlr-randr 0.5.0-r2 (Chainguard OS)