Arch manual pages

AUTORANDR(1) General Commands Manual AUTORANDR(1)

autorandr - automatically select a display configuration based on connected devices

autorandr [OPTION] [PROFILE]

This program automatically detects connected display hardware and then loads an appropriate X11 setup using xrandr. It also supports the use of display profiles for different hardware setups.

Autorandr also includes several virtual configurations including off, common, clone-largest, horizontal, and vertical. See the documentation for explanation of each.

-h, --help
Display help text and exit
-c, --change
Automatically load the first detected profile
-d, --default PROFILE
Make profile PROFILE the default profile. The default profile is used if no suitable profile can be identified. Else, the current configuration is kept.
-l, --load PROFILE
Load profile PROFILE
-s, --save PROFILE
Save the current setup to profile PROFILE
-r, --remove PROFILE
Remove profile PROFILE
Run autorandr for all users with active X11 sessions
List only the current (active) configuration(s)
Dump the variable values of your current xrandr setup
Enable verbose output
List only the detected (i.e. available) configuration(s)
Don't change anything, only print the xrandr commands
Fingerprint the current hardware setup
Force loading or reloading of a profile
--skip-options [OPTION] ...
Set a comma-separated list of xrandr arguments to skip both in change detection and profile application. See xrandr(1) for xrandr arguments.
Show version information and exit

Phillip Berndt <>
See for a full list of contributors.

Report issues upstream on GitHub:
Please attach the output of xrandr --verbose to your bug report if appropriate.

For examples, advanced usage (including predefined per-profile & global hooks and wildcard EDID matching), and full documentation, see