1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4.
2 .TH AUTORANDR "1" "October 2017" "autorandr 1.2" "Automatically change screen layout"
4 autorandr \- Automatically change screen layout
10 \fB\-h\fR, \fB\-\-help\fR
15 \fB\-c\fR, \fB\-\-change\fR
20 \fB\-s\fR, \fB\-\-save\fR <profile>
22 save your current setup to profile <profile>
25 \fB\-r\fR, \fB\-\-remove\fR <profile>
27 remove profile <profile>
30 \fB\-l\fR, \fB\-\-load\fR <profile>
32 load profile <profile>
35 \fB\-d\fR, \fB\-\-default\fR <profile>
37 make profile <profile> the default profile
40 \fB\-\-skip\-options\fR <option>
42 comma separated list of xrandr arguments (e.g. "gamma")
43 to skip both in detecting changes and applying a profile
48 force (re)loading of a profile
53 fingerprint your current hardware setup
58 dump your current xrandr setup
63 don't change anything, only print the xrandr commands
73 run autorandr for all users with active X11 sessions
77 To prevent a profile from being loaded, place a script called "block" in its
78 directory. The script is evaluated before the screen setup is inspected, and
79 in case of it returning a value of 0 the profile is skipped. This can be used
80 to query the status of a docking station you are about to leave.
82 If no suitable profile can be identified, the current configuration is kept.
83 To change this behaviour and switch to a fallback configuration, specify
84 \fB\-\-default\fR <profile>.
86 Another script called "postswitch" can be placed in the directory
87 ~/.config/autorandr (or ~/.autorandr if you have an old installation) as well
88 as in any profile directories: The scripts are executed after a mode switch
89 has taken place and can notify window managers.
90 .SH "VIRTUAL CONFIGURATIONS"
91 The following virtual configurations are available:
94 Clone all connected outputs at the largest common resolution
97 Clone all connected outputs with the largest resolution (scaled down if necessary)
100 Stack all connected outputs horizontally at their largest resolution
103 Stack all connected outputs vertically at their largest resolution
105 # save the current setup and make it the default
107 autorandr \-\-save mysetup
109 autorandr \-\-default mysetup
111 # put laptop in dock (or plug in additional monitors)
113 # run appropriate xrandr commands to fix things up
115 autorandr \-\-save docked_setup
117 # now remove the laptop from the dock, and settings return to mysetup
119 Autorandr is written and maintained by Phillip Berndt, with
120 contributions by many others. See
121 https://github.com/phillipberndt/autorandr for more information.