autorandr(1)

1AUTORANDR(1)                General Commands Manual               AUTORANDR(1)
2
3
4

NAME

6       autorandr  - automatically select a display configuration based on con‐
7       nected devices
8

SYNOPSIS

10       autorandr [OPTION] [PROFILE]
11

DESCRIPTION

13       This program automatically detects connected display hardware and  then
14       loads  an  appropriate X11 setup using xrandr. It also supports the use
15       of display profiles for different hardware setups.
16
17       Autorandr also includes several virtual configurations  including  off,
18       common,  clone-largest, horizontal, and vertical. See the documentation
19       for explanation of each.
20

OPTIONS

22       -h, --help
23              Display help text and exit
24
25       -c, --change
26              Automatically load the first detected profile
27
28       -d, --default PROFILE
29              Make profile PROFILE the default profile. The default profile is
30              used if no suitable profile can be identified. Else, the current
31              configuration is kept.
32
33       -l, --load PROFILE
34              Load profile PROFILE
35
36       -s, --save PROFILE
37              Save the current setup to profile PROFILE
38
39       -r, --remove PROFILE
40              Remove profile PROFILE
41
42       --batch
43              Run autorandr for all users with active X11 sessions
44
45       --current
46              List only the current (active) configuration(s)
47
48       --config
49              Dump the variable values of your current xrandr setup
50
51       --cycle
52              Cycle through all detected profiles
53
54       --debug
55              Enable verbose output
56
57       --detected
58              List only the detected (i.e. available) configuration(s)
59
60       --dry-run
61              Don't change anything, only print the xrandr commands
62
63       --fingerprint
64              Fingerprint the current hardware setup
65
66       --match-edid
67              Match displays based on edid instead of name
68
69       --force
70              Force loading or reloading of a profile
71
72       --list List all profiles
73
74       --skip-options [OPTION] ...
75              Set a comma-separated list of xrandr arguments to skip  both  in
76              change  detection  and  profile  application.  See xrandr(1) for
77              xrandr arguments.
78
79       --version
80              Show version information and exit
81

FILES

83       Configuration files are searched for in the autorandr directory in  the
84       colon  separated  list of paths in $XDG_CONFIG_DIRS - or in /etc/xdg if
85       that var is not set.  They are then looked for in ~/.autorandr  and  if
86       that  doesn't  exist, in $XDG_CONFIG_HOME/autorandr or in ~/.config/au‐
87       torandr if that var is unset.
88
89       In each of those directories it looks for directories with  config  and
90       setup  in  them.   It  is best to manage these files with the autorandr
91       utility.
92

AUTHOR

94       Phillip Berndt <phillip.berndt@googlemail.com>
95       See https://github.com/phillipberndt/autorandr for a full list of  con‐
96       tributors.
97

REPORTING BUGS

99       Report issues upstream on GitHub:  https://github.com/phillipberndt/au‐
100       torandr/issues
101       Please attach the output of xrandr --verbose to your bug report if  ap‐
102       propriate.
103