README.md

   1 # autorandr
   2 Automatically select a display configuration based on connected devices
   3
   4 ## Branch information
   5
   6 This is a compatible Python rewrite of
   7 [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr).
   8
   9 The original [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr)
  10 tree is unmaintained, with lots of open pull requests and issues. I forked it
  11 and merged what I thought were the most important changes. If you are searching
  12 for that version, see the [`legacy` branch](https://github.com/phillipberndt/autorandr/tree/legacy).
  13 Note that the Python version is better suited for non-standard configurations,
  14 like if you use `--transform` or `--reflect`. If you use `auto-disper`, you
  15 have to use the bash version, as there is no disper support in the Python
  16 version (yet). Both versions use a compatible configuration file format, so
  17 you can, to some extent, switch between them.  I will maintain the `legacy`
  18 branch until @wertarbyte finds the time to maintain his branch again.
  19
  20 If you are interested in why there are two versions around, see
  21 [#7](https://github.com/phillipberndt/autorandr/issues/7),
  22 [#8](https://github.com/phillipberndt/autorandr/issues/8) and
  23 especially
  24 [#12](https://github.com/phillipberndt/autorandr/issues/12)
  25 if you are unhappy with this version and would like to contibute to the bash
  26 version.
  27
  28 ## License information and authors
  29
  30 autorandr is available under the terms of the GNU General Public License
  31 (version 3).
  32
  33 Contributors to this version of autorandr are:
  34
  35 * Alexander Wirt
  36 * Chris Dunder
  37 * Maciej Sitarz
  38 * Matthew R Johnson
  39 * Phillip Berndt
  40 * Rasmus Wriedt Larsen
  41 * Stefan Tomanek
  42 * Timo Bingmann
  43 * Tomasz Bogdal
  44 * Victor Häggqvist
  45 * stormc
  46 * tachylatus
  47 * andersonjacob
  48
  49 ## How to use
  50
  51 Save your current display configuration and setup with:
  52 ```
  53 autorandr --save mobile
  54 ```
  55
  56 Connect an additional display, configure your setup and save it:
  57 ```
  58 autorandr --save docked
  59 ```
  60
  61 Now autorandr can detect which hardware setup is active:
  62 ```
  63  $ autorandr
  64    mobile
  65    docked (detected)
  66 ```
  67
  68 To automatically reload your setup, just append `--change` to the command line
  69
  70 To manually load a profile, you can use the `--load <profile>` option.
  71
  72 autorandr tries to avoid reloading an identical configuration. To force the
  73 (re)configuration, apply `--force`.
  74
  75 To prevent a profile from being loaded, place a script call _block_ in its
  76 directory. The script is evaluated before the screen setup is inspected, and
  77 in case of it returning a value of 0 the profile is skipped. This can be used
  78 to query the status of a docking station you are about to leave.
  79
  80 If no suitable profile can be identified, the current configuration is kept.
  81 To change this behaviour and switch to a fallback configuration, specify
  82 `--default <profile>`.
  83
  84 Another script called `postswitch` can be placed in the directory
  85 `~/.config/autorandr` (or `~/.autorandr` if you have an old installation) as well as in all profile directories: The scripts are executed
  86 after a mode switch has taken place and can notify window managers or other
  87 applications about it.
  88
  89 To install autorandr call `make install`, define your setup and then call
  90 `make hotplug` to install hotplug scripts.