.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH AUTORANDR "1" "October 2017" "autorandr 1.2" "Automatically change screen layout"
.SH NAME
autorandr \- Automatically change screen layout
.SH SYNOPSIS
.B autorandr
[\fI\,options\/\fR]
.SH OPTIONS
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
get this small help
.RE
.PP
\fB\-c\fR, \fB\-\-change\fR
.RS 4
reload current setup
.RE
.PP
\fB\-s\fR, \fB\-\-save\fR <profile>
.RS 4
save your current setup to profile <profile>
.RE
.PP
\fB\-r\fR, \fB\-\-remove\fR <profile>
.RS 4
remove profile <profile>
.RE
.PP
\fB\-l\fR, \fB\-\-load\fR <profile>
.RS 4
load profile <profile>
.RE
.PP
\fB\-d\fR, \fB\-\-default\fR <profile>
.RS 4
use profile <profile> if no other profile matches. [Most useful if set
in ~/.config/autorandr/settings.ini].
.RE
.PP
\fB\-\-skip\-options\fR <option>
.RS 4
comma separated list of xrandr arguments (e.g. "gamma")
to skip both in detecting changes and applying a profile
.RE
.PP
\fB\-\-force\fR
.RS 4
force (re)loading of a profile
.RE
.PP
\fB\-\-fingerprint\fR
.RS 4
fingerprint your current hardware setup
.RE
.PP
\fB\-\-config\fR
.RS 4
dump your current xrandr setup
.RE
.PP
\fB\-\-dry\-run\fR
.RS 4
don't change anything, only print the xrandr commands
.RE
.PP
\fB\-\-debug\fR
.RS 4
enable verbose output
.RE
.PP
\fB\-\-batch\fR
.RS 4
run autorandr for all users with active X11 sessions
.RE
.PP
.SH "CONFIGURATION"
To prevent a profile from being loaded, place a script called "block" in its
directory. The script is evaluated before the screen setup is inspected, and
in case of it returning a value of 0 the profile is skipped. This can be used
to query the status of a docking station you are about to leave.
.PP
If no suitable profile can be identified, the current configuration is kept.
To change this behaviour and switch to a fallback configuration, specify
\fB\-\-default\fR <profile>.
.PP
Another script called "postswitch" can be placed in the directory
~/.config/autorandr (or ~/.autorandr if you have an old installation) as well
as in any profile directories: The scripts are executed after a mode switch
has taken place and can notify window managers.
.SH "VIRTUAL CONFIGURATIONS"
The following virtual configurations are available:
.TP
common
Clone all connected outputs at the largest common resolution
.TP
clone\-largest
Clone all connected outputs with the largest resolution (scaled down if necessary)
.TP
horizontal
Stack all connected outputs horizontally at their largest resolution
.TP
vertical
Stack all connected outputs vertically at their largest resolution
.SH "EXAMPLES"
# save the current setup and set default
.RE
autorandr \-\-save mysetup
.RE
echo -e '[config]\\ndefault=mysetup' > ~/.config/autorandr/settings.ini
.RE
# put laptop in dock (or plug in additional monitors)
.RE
# run appropriate xrandr commands to fix things up
.RE
autorandr \-\-save docked_setup
.RE
# now remove the laptop from the dock, and settings return to mysetup
.SH "AUTHORS"
Autorandr is written and maintained by Phillip Berndt, with
contributions by many others. See
https://github.com/phillipberndt/autorandr for more information.
.SH "SEE ALSO"
.sp
\fBxrandr(1)\fR