wlr-randr(1)
Manage outputs and modes for Wayland compositors using wlr-output-management.
Synopsis
wlr-randr [OPTION]... [OUTPUT]...Description
wlr-randr is a utility for configuring displays on Wayland compositors that support the wlr-output-management protocol. It allows you to query connected outputs, enable or disable displays, set resolutions and refresh rates, and adjust positioning—similar to xrandr on X11.
The tool communicates with the Wayland compositor (such as Sway, Hyprland, or Weston) to enumerate available monitors and apply display configurations. Changes take effect immediately and persist according to the compositor's configuration.
Common options
| Flag | What it does |
|---|---|
--help | display help message and exit |
--output OUTPUT | select output by name (e.g., HDMI-1, eDP-1) |
--mode WIDTHxHEIGHT@RATE | set resolution and refresh rate (e.g., 1920x1080@60) |
--pos X,Y | set output position relative to other outputs |
--scale SCALE | set fractional scaling factor (e.g., 1.5, 2) |
--transform TRANSFORM | rotate output (normal, 90, 180, 270, flipped, flipped-90, flipped-180, flipped-270) |
--on | enable output |
--off | disable output |
--adaptive-sync on|off | enable or disable variable refresh rate |
Examples
list all connected outputs and available modes
wlr-randrenable HDMI-1 and set it to 1920x1080 at 60 Hz
wlr-randr --output HDMI-1 --mode 1920x1080@60 --onscale laptop display to 1.5x and rotate 90 degrees
wlr-randr --output eDP-1 --scale 1.5 --transform 90position HDMI-1 on left and eDP-1 on right
wlr-randr --output HDMI-1 --pos 0,0 --output eDP-1 --pos 1920,0disable the DP-2 output
wlr-randr --output DP-2 --offenable variable refresh rate (FreeSync/G-Sync) on HDMI-1
wlr-randr --output HDMI-1 --adaptive-sync on