$linuxjunkies
>

wlr-randr

also: wlr_randr

A command-line tool for managing displays and their output modes on Wayland compositors that implement the wlr-output-management protocol.

wlr-randr is a utility designed for Wayland environments, particularly those using wlroots-based compositors like Sway. It serves the same purpose as xrandr does for X11—allowing users to query and configure connected monitors from the terminal.

The tool can list all connected displays, their resolutions, refresh rates, and current settings. Users can enable or disable outputs, change resolutions, adjust scaling, set refresh rates, and position monitors relative to each other.

Example usage:
wlr-randr lists all outputs
wlr-randr --output HDMI-1 --mode 1920x1080@60Hz sets a specific resolution and refresh rate
wlr-randr --output HDMI-1 --off disables a display

It relies on the wlr-output-management Wayland protocol, making it essential for multi-monitor setups on modern Wayland desktops where traditional X11 tools don't work.

Related terms