README

   1 Tool: "autorandr"
   2
   3 Automatically select a display configuration based on connected devices
   4
   5 Stefan Tomanek <stefan.tomanek@wertarbyte.de>
   6
   7 How to use:
   8
   9 Save your current display configuration and setup with:
  10  $ autorandr --save mobile
  11
  12 Connect an additional display, configure your setup and save it:
  13  $ autorandr --save docked
  14
  15 Now autorandr can detect which hardware setup is active:
  16  $ autorandr
  17    mobile
  18    docked (detected)
  19
  20 To automatically reload your setup, just append --change to the command line
  21
  22 To manually load a profile, you can use the --load <profile> option.
  23
  24 autorandr tries to avoid reloading an identical configuration. To force the
  25 (re)configuration, apply --force.
  26
  27 To prevent a profile from being loaded, place a script call "block" in its
  28 directory. The script is evaluated before the screen setup is inspected, and
  29 in case of it returning a value of 0 the profile is skipped. This can be used
  30 to query the status of a docking station you are about to leave.
  31
  32 If no suitable profile can be identified, the current configuration is kept.
  33 To change this behaviour and switch to a fallback configuration, specify
  34 --default <profile>
  35
  36 Another script called "postswitch "can be placed in the directory
  37 ~/.autorandr as well as in all profile directories: The scripts are executed
  38 after a mode switch has taken place and can notify window managers or other
  39 applications about it.
  40
  41
  42 While the script uses xrandr by default, calling it by the name "autodisper"
  43 or "auto-disper" forces it to use the "disper" utility, which is useful for
  44 controlling nvidia chipsets. The formats for fingerprinting the current setup
  45 and saving/loading the current configuration are adjusted accordingly.
  46