NAME

       autorandr - Automatically change screen layout

SYNOPSIS

       autorandr [options]

OPTIONS

       -h, --help
           get this small help

       -c, --change
           reload current setup

       -s, --save <profile>
           save your current setup to profile <profile>

       -r, --remove <profile>
           remove profile <profile>

       -l, --load <profile>
           load profile <profile>

       -d, --default <profile>
           make profile <profile> the default profile

       --skip-options <option>
           comma  separated  list  of  xrandr  arguments (e.g. "gamma") to skip both in detecting
           changes and applying a profile

       --force
           force (re)loading of a profile

       --fingerprint
           fingerprint your current hardware setup

       --config
           dump your current xrandr setup

       --dry-run
           don't change anything, only print the xrandr commands

       --debug
           enable verbose output

       --batch
           run autorandr for all users with active X11 sessions

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.

       If  no  suitable  profile can be identified, the current configuration is kept.  To change
       this behaviour and switch to a fallback configuration, specify --default <profile>.

       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.

VIRTUAL CONFIGURATIONS

       The following virtual configurations are available:

       common Clone all connected outputs at the largest common resolution

       clone-largest
              Clone all connected outputs with the largest resolution (scaled down if necessary)

       horizontal
              Stack all connected outputs horizontally at their largest resolution

       vertical
              Stack all connected outputs vertically at their largest resolution

EXAMPLES

       # save the current setup and make it the default
       autorandr --save mysetup
       autorandr --default mysetup
       # put laptop in dock (or plug in additional monitors)
       # run appropriate xrandr commands to fix things up
       autorandr --save docked_setup
       # now remove the laptop from the dock, and settings return to mysetup

AUTHORS

       Autorandr is written and maintained by Phillip Berndt, with contributions by many  others.
       See https://github.com/phillipberndt/autorandr for more information.

SEE ALSO

       xrandr(1)