RRandR - A graphical interface to the RandR X Window System extension

About

RRandR is a graphical interface to the X Resize, Rotate and Reflect Extension (RandR). It aims to provide the core features of the official command line configuration utility xrandr in an easy accessible manner. RRandR was mainly developed for users running an X Server without a desktop environment as an alternative to other standalone graphical tools like ARandR, lxrandr or grandr. It can however be used side-by-side with destkop-integrated system tools.

Features

• Position outputs in a screen by dragging
• Enable and disable outputs
• Change resolution and refresh rate
• Set primary output
• Rotate, reflect and scale output
• Automatic revert after timeout
• Human-readable output names
• Visual output identification
• Update view on external screen configuration changes
• Run custom script on applying and reverting changes
• Convenient shortcuts (see Ctrl + ?)
• Configurable light and dark theme colors for dragging area (see: configuration)
• Show optional xrandr command
• Localization

Installation

For Arch Linux users an upstream version of RRandR is available in the Arch User Repository (AUR): rrandr-git.

Manual Build & Installation

Build

• Install build dependencies:
  • rustup, gettext
  • Arch Linux: pacman -S rustup gettext
• Install dependencies:
  • gtk4, pango, cairo, libxcb, glib2, glibc, gcc-libs
  • Dependency names might differ depending on your distribution
  • Arch Linux: pacman -S gtk4
• Get, build & run:
  • git clone https://github.com/brofi/rrandr
  • cd rrandr
  • cargo build --release
  • target/release/rrandr

Install (optional)

#!/bin/bash
# Run as superuser from project root

# Install binary
install -Dm755 target/release/rrandr -t /usr/bin
# Install license
install -Dm644 COPYING -t /usr/share/licenses/rrandr
# Install logo
install -Dm644 rrandr/src/res/rrandr.svg -t /usr/share/pixmaps
# Install desktop file
desktop-file-install rrandr/src/res/rrandr.desktop
update-desktop-database
# Install translations
mapfile -t linguas < rrandr/po/LINGUAS
for lang in "${linguas[@]}"; do
    install -Dm644 "target/po/$lang/LC_MESSAGES/rrandr.mo" -t \
        "/usr/share/locale/$lang/LC_MESSAGES"
done

Configuration

RRandR is configured via a TOML configuration file. A configuration can be put in the following locations:

1. $XDG_CONFIG_HOME/rrandr/rrandr.toml
2. $XDG_CONFIG_HOME/rrandr.toml
3. $HOME/.rrandr.toml

Where $XDG_CONFIG_HOME if unset defaults to $HOME/.config.

The following sections describe all available configuration attributes grouped by TOML table.

[] Root level configuration

Attribute	Type	Default	Description
show_xrandr	Boolean	false	Show an additional xrandr command for the current configuration
revert_timeout	Integer	15	Time in seconds until applied changes are being reverted
apply_hook	String	``	Execute this child program when the screen configuration has been applied successfully. Useful for example to reset a wallpaper when not using a desktop environment. Variable expansion, globs, operators, filename expansion, etc. are not supported.
revert_hook	String	``	Execute this child program when the screen configuration has been reverted.

[display] Output area configuration

Attribute	Type	Default	Description
snap_strength	Float or "auto"	auto	Snapping strength when dragging outputs or auto. High values make it more "sticky", while 0 means no snapping. If left to default snap_strength = min_size / 6 where min_side is the smallest side of any enabled output in px. E.g. when smallest screen resolution is Full HD => snap_strength = 180.
pos_move_dist	Integer	10	Move distance when moving an output via keybindings
output_line_width	Float	3.5	Thickness of the output outline in px
output_line_style	BorderStyle	solid	Style of the output outline
selection_line_width	Float	3.5	Thickness of the selection outline in px
selection_line_style	BorderStyle	solid	Style of the selection outline
screen_line_width	Float	2.5	Thickness of the screen outline in px
screen_line_style	BorderStyle	dashed	Style of the screen outline

[display.font] Output area font configuration

Attribute	Type	Default	Description
family	String	monospace	Font family
size	Integer	12	Font size in pt
weight	Weight	bold	Font weight

[display.colors.light] Output area light theme colors

Attribute	Type	Default	Description
text	Color	#000000	Output name text color
output	Color	#e8e6e3	Output background color
border	Color	#d8d4d0	Output border color
screen	Color	#cdc7c2	Screen rectangle color
selection	Color	#3584e4	Output selection color

[display.colors.dark] Output area dark theme colors

Attribute	Type	Default	Description
text	Color	#ffffff	Output name text color
output	Color	#202020	Output background color
border	Color	#282828	Output border color
screen	Color	#1b1b1b	Screen rectangle color
selection	Color	#1b68c6	Output selection color

[popup] Identify popup configuration

Attribute	Type	Default	Description
ratio	Float	0.125	Resolution to popup size ratio
padding	Integer	5	Padding in mm
spacing	Integer	10	Margin from screen edge in mm
border_width	Integer	1	Border width in mm
timeout	Float	2.5	Time in seconds the identify popup stays on screen

[popup.font] Identify popup font configuration

Attribute	Type	Default	Description
family	String	Sans	Font family
size	Integer or "auto"	auto	Font size in pt or "auto"
weight	Weight	bold	Font weight

[popup.colors.light] Identify popup light theme colors

Attribute	Type	Default	Description
text	Color	#000000	Text color
background	Color	#f6f5f4	Background color
border	Color	#cdc7c2	Border color

[popup.colors.dark] Identify popup dark theme colors

Attribute	Type	Default	Description
text	Color	#ffffff	Text color
background	Color	#353535	Background color
border	Color	#1b1b1b	Border color