-# autorandr
+# autorandr
+
Automatically select a display configuration based on connected devices
## Branch information
This is a compatible Python rewrite of
-[wertarbyte/autorandr](https://github.com/wertarbyte/autorandr). Contributions for bash-completion, fd.o/XDG autostart, Nitrogen, pm-utils, and systemd can be found under [contrib](contrib/).
+[wertarbyte/autorandr](https://github.com/wertarbyte/autorandr). Contributions
+for bash-completion, fd.o/XDG autostart, Nitrogen, pm-utils, and systemd can be
+found under [contrib](contrib/).
The original [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr)
tree is unmaintained, with lots of open pull requests and issues. I forked it
[#8](https://github.com/phillipberndt/autorandr/issues/8) and
especially
[#12](https://github.com/phillipberndt/autorandr/issues/12)
-if you are unhappy with this version and would like to contibute to the bash
+if you are unhappy with this version and would like to contribute to the bash
version.
## License information and authors
* andersonjacob
* Alexander Wirt
* Chris Dunder
+* Christoph Gysin
* Daniel Hahler
* Maciej Sitarz
* Mathias Svensson
* Victor Häggqvist
## Installation/removal
+
You can use the `autorandr.py` script as a stand-alone binary. If you'd like to
install it as a system-wide application, there is a Makefile included that also
places some configuration files in appropriate directories such that autorandr
or simply
- sudo pip install autorandr
+ sudo pip install autorandr
if you prefer to use a stable version.
mobile
docked (detected)
-To automatically reload your setup, just append `--change` to the command line
+To automatically reload your setup:
+
+ $ autorandr --change
+
+To manually load a profile:
-To manually load a profile, you can use the `--load <profile>` option.
+ $ autorandr --load <profile>
+
+or simply:
+
+ $ autorandr <profile>
autorandr tries to avoid reloading an identical configuration. To force the
-(re)configuration, apply `--force`.
+(re)configuration:
+
+ $ autorandr --load <profile> --force
To prevent a profile from being loaded, place a script call _block_ in its
directory. The script is evaluated before the screen setup is inspected, and