README.md

   1 # autorandr
   2
   3 Automatically select a display configuration based on connected devices
   4
   5 ## Branch information
   6
   7 The original [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr)
   8 tree is unmaintained, with lots of open pull requests and issues. I forked
   9 it and merged what I thought were the most important changes. I will maintain
  10 this branch until @wertarbyte finds the time to maintain his branch again.
  11
  12 ## License information and authors
  13
  14 autorandr is available under the terms of the GNU General Public License
  15 (version 3).
  16
  17 Contributors to this version of autorandr are:
  18
  19 * Alexander Wirt
  20 * Chris Dunder
  21 * Maciej Sitarz
  22 * Matthew R Johnson
  23 * Phillip Berndt
  24 * Rasmus Wriedt Larsen
  25 * Stefan Tomanek
  26 * Timo Bingmann
  27 * Tomasz Bogdal
  28 * stormc
  29 * tachylatus
  30
  31 ## autorandr vs. autorandr.py
  32
  33 The two files `autorandr` and `autorandr.py` are two independent versions of
  34 autorandr. For now, both are here, but I might move one of both versions into
  35 its own branch or repository someday. See [bug #7](https://github.com/phillipberndt/autorandr/issues/7)
  36 for details on why there are two versions around.
  37
  38 The two versions are compatible with respect to the profile format and command
  39 line parameters, but
  40
  41 * the *Python version* does not support auto-disper
  42 * the *bash version* does not support changes in available adapters and slightly esoteric configurations (like transformations and reflections)
  43
  44 Active development in this repository is likely to occur preferably in the
  45 Python version.
  46
  47 ## How to use
  48
  49 Save your current display configuration and setup with:
  50 ```
  51 autorandr --save mobile
  52 ```
  53
  54 Connect an additional display, configure your setup and save it:
  55 ```
  56 autorandr --save docked
  57 ```
  58
  59 Now autorandr can detect which hardware setup is active:
  60 ```
  61  $ autorandr
  62    mobile
  63    docked (detected)
  64 ```
  65
  66 To automatically reload your setup, just append `--change` to the command line
  67
  68 To manually load a profile, you can use the `--load <profile>` option.
  69
  70 autorandr tries to avoid reloading an identical configuration. To force the
  71 (re)configuration, apply `--force`.
  72
  73 To prevent a profile from being loaded, place a script call _block_ in its
  74 directory. The script is evaluated before the screen setup is inspected, and
  75 in case of it returning a value of 0 the profile is skipped. This can be used
  76 to query the status of a docking station you are about to leave.
  77
  78 If no suitable profile can be identified, the current configuration is kept.
  79 To change this behaviour and switch to a fallback configuration, specify
  80 `--default <profile>`.
  81
  82 Another script called `postswitch` can be placed in the directory
  83 `~/.autorandr` as well as in all profile directories: The scripts are executed
  84 after a mode switch has taken place and can notify window managers or other
  85 applications about it.
  86
  87 While the script uses xrandr by default, calling it by the name `autodisper`
  88 or `auto-disper` forces it to use the [disper](http://willem.engen.nl/projects/disper/)
  89 utility, which is useful for controlling nvidia chipsets. The formats for
  90 fingerprinting the current setup and saving/loading the current configuration
  91 are adjusted accordingly.
  92
  93 To install autorandr call `make install`, define your setup and then call
  94 `make hotplug` to install hotplug scripts.
  95
  96 For Debian using auto-disper:
  97 To make the screen auto-configure when your computer wakes up,
  98 * Copy auto-disper into /usr/local/bin/
  99 * Copy pm-utils/40auto-disper into /etc/pm/sleep.d/
 100 * (Assuming gnome) Run gnome-keybinding-properties and ADD a shortcut,
 101   I called it "Run auto-disper", I set it to CTRL-F7, and the command is:
 102   `auto-disper -c --default default`
 103 * Create a default disper setting... eg for laptop: unplug all monitors,
 104   set up the screen nicely on the laptop display.
 105   Then run `auto-disper --save laptop`