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
- --batch
- Run autorandr for all users with active X11 sessions
- --current
- List only the current (active) configuration(s)
- --config
- Dump the variable values of your current xrandr setup
- --cycle
- Cycle through all detected profiles
- --debug
- Enable verbose output
- --detected
- List only the detected (i.e. available)
configuration(s)
- --dry-run
- Don't change anything, only print the xrandr commands
- --fingerprint
- Fingerprint the current hardware setup
- --match-edid
- Match displays based on edid instead of name
- --force
- Force loading or reloading of a profile
- --list
- List all profiles
-
--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.
- --version
- Show version information and exit
Configuration files are searched for in the
autorandr directory in
the colon separated list of paths in
$XDG_CONFIG_DIRS - or in
/etc/xdg if that var is not set. They are then looked for in
~/.autorandr and if that doesn't exist, in
$XDG_CONFIG_HOME/autorandr or in
~/.config/autorandr if
that var is unset.
In each of those directories it looks for directories with
config and
setup in them. It is best to manage these files with the
autorandr utility.
Phillip Berndt <
[email protected]>
See
https://github.com/phillipberndt/autorandr for a full list of contributors.
Report issues upstream on GitHub:
https://github.com/phillipberndt/autorandr/issues
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
https://github.com/phillipberndt/autorandr.