WLR-RANDR(1)

📦
version 0.5.0 · 7 versions
, in alpine 3.24

✨ wlr-randr — the glow-up your screens deserve ✨

okay so bestie, the manual page name is wlr-randr(1) and it lives in section 1 of the General Commands Manual, and it is literally the tool you use to manage the outputs of a Wayland compositor. that's the whole vibe. 💅

🌸 NAME 🌸

wlr-randr — a utility to manage outputs of a Wayland compositor 🫶

🎀 SYNOPSIS 🎀

wlr-randr [options...]

🦋 DESCRIPTION 🦋

so it's a command line interface, right, and what it does is let you set the size, the scale, and the orientation of the output for a screen. iconic. that's it, that's the job. 👑

but here's the catch, and it's giving plot twist: this utility requires the compositor to implement the wlr-output-management protocol. no protocol, no slay. that's non-negotiable, i don't make the rules. 😭

✨ OPTIONS ✨

  • --help — shows the help message. the "wait what does this do again" button. 💖
  • --dryrun — performs all the actions you specified, except that no changes are applied. it's the dress rehearsal bestie, nothing actually happens on your screen. 🎭
  • --json — prints the current state as JSON. for the girlies who like their data structured and their vibes immaculate. 🌈
  • --output <name> — selects an output to reconfigure. this option must be set when making changes to the output using the options below. lowkey mandatory for any actual reconfiguring, iykyk. 🎯
  • --on — enables the selected output. wake up queen. ⭐
  • --off — disables the selected output. she's resting. 💀
  • --mode | --custom-mode <width>x<height>[@<refresh>Hz] — sets the output resolution, and optionally the refresh rate. put that @ and Hz in there only if you want to be specific about the refresh, bestie. 🖥️
  • --pos <x>,<y> — positions the output using absolute layout coordinates. yes, comma between them, don't come for me. 📍
  • --left-of, --right-of, --above, --below <another-output> — positions the output relative to an existing output. and here's the tea: absolute positioning via --pos overwrites a previously established relative position, and vice versa. whichever positioning option you pass last on the command-line takes precedence. periodt. 🫶
  • --transform normal|90|180|270|flipped|flipped-90|flipped-180|flipped-270 — transforms the output by rotating it following the value you provided. all those exact values, no improvising. 🔄
  • --scale <factor> — scales the specified output by the specified scale factor. an integer is recommended, but fractional values are also supported. ⚠️ but if you go fractional, be warned: it's not possible to faithfully represent the contents of your windows — they will be rendered at the next highest integer scale factor and then downscaled. so like, it works, but it's not giving pixel-perfect, and you should know that going in. 🙈

💜 SEE ALSO 💜

  • xrandr(1) — the cousin. different era, same energy.

👑 AUTHORS 👑

maintained by Simon Ser <contact@emersion.fr> 💌

for more information about wlr-randr development, see <https://gitlab.freedesktop.org/emersion/wlr-randr>.

ngl bestie, always do a --dryrun first. your future self will thank you. 🫶

and that's the whole page, mwah 💋 — dated 2025-03-19, from the wlr-randr(1) manual, General Commands Manual. go forth and configure those outputs, you absolute icon. 🧚💖

📦 where this page comes from