NAME

       autorandr - automatically select a display configuration based on connected devices

SYNOPSIS

       autorandr [OPTION] [PROFILE]

DESCRIPTION

       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.

OPTIONS

       -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

       --ignore-lid
              By  default,  closed  lids  are  considered  as  disconnected  if other outputs are
              detected. This flag disables this behaviour.

       --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

FILES

       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.

DEFAULT OPTIONS

       You   can   store   default   values   for   any   option   in   an  INI-file  located  at
       ~/.config/autorandr/settings.ini. In a config section, you may place any default values in
       the form option-name=option-argument.

HOOK SCRIPTS

       Four more scripts can be placed in the configuration directory:

       postswitch
              Executed  after  a  mode  switch has taken place. This can be used to notify window
              managers or other applications about the switch.

       preswitch
              Executed before a mode switch takes place.

       postsave
              Executed after a profile was stored or altered.

       predetect
              Executed before autorandr attempts to run xrandr.

       These scripts must  be  executable  and  can  be  placed  directly  in  the  configuration
       directory,  where  they  will  always be executed, or in the profile subdirectories, where
       they will only be executed on changes regarding that specific profile.

       Instead (or in addition) to these scripts, you can also place as many executable files  as
       you like in subdirectories called script_name.d (e.g. postswitch.d).

       Some  of  autorandr's  state is exposed as environment variables prefixed with AUTORANDR_,
       such as: AUTORANDR_CURRENT_PROFILE, AUTORANDR_CURRENT_PROFILES,  AUTORANDR_PROFILE_FOLDER,
       and AUTORANDR_MONITORS with the intention that they can be used within the hook scripts.

       The one kink is that during preswitch, AUTORANDR_CURRENT_PROFILE is reporting the upcoming
       profile rather than the current one.

AUTHOR

       Phillip Berndt <phillip.berndt@googlemail.com>
       See https://github.com/phillipberndt/autorandr for a full list of contributors.

REPORTING BUGS

       Report issues upstream on GitHub:  https://github.com/phillipberndt/autorandr/issues
       Please attach the output of xrandr --verbose to your bug report if appropriate.

SEE ALSO

       For examples, advanced usage (including predefined per-profile & global hooks and wildcard
       EDID matching), and full documentation, see https://github.com/phillipberndt/autorandr.

                                                                                     AUTORANDR(1)