---
name: "wlr-randr"
section: "1"
platform: "linux"
package: "wlr-randr"
version: "0.5.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/wlr-randr"
---

# wlr-randr(1)

Utility to manage outputs of a Wayland compositor

## 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)](/xrandr/1.md)

## AUTHORS

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