X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=README.md;h=c420a36109aeb9c13ed0bab3efe4d49b619897a8;hb=81008be9f9f774c5b3af824b0071b86d69efcc67;hp=5fb8ac11517687f202684fffd4ce008de5220bdb;hpb=e0dfa631a21d7d30424a4ba9dde26faeedfcd224;p=deb_pkgs%2Fautorandr.git diff --git a/README.md b/README.md index 5fb8ac1..c420a36 100644 --- a/README.md +++ b/README.md @@ -34,15 +34,28 @@ Contributors to this version of autorandr are: * Alexander Wirt * Chris Dunder +* Daniel Hahler * Maciej Sitarz +* Mathias Svensson * Matthew R Johnson +* Nazar Mokrynskyi * Phillip Berndt * Rasmus Wriedt Larsen * Stefan Tomanek * Timo Bingmann * Tomasz Bogdal +* Victor Häggqvist * stormc * tachylatus +* andersonjacob +* Simon Wydooghe + +## Installation/removal +For Debian-based distributives (including Ubuntu) it is recommended to call `make deb` to obtain package that can be afterwards installed and removed with `dpkg`. + +On other distributives you can install autorandr by calling `make install` and remove by calling `make uninstall`. + +If you can contribute packaging script for other distributives, we will appreciate it. ## How to use @@ -80,9 +93,20 @@ To change this behaviour and switch to a fallback configuration, specify `--default `. Another script called `postswitch` can be placed in the directory -`~/.autorandr` as well as in all profile directories: The scripts are executed -after a mode switch has taken place and can notify window managers or other -applications about it. - -To install autorandr call `make install`, define your setup and then call -`make hotplug` to install hotplug scripts. +`~/.config/autorandr` (or `~/.autorandr` if you have an old installation) as +well as in all profile directories: The scripts are executed after a mode +switch has taken place and can notify window managers or other applications +about it. The same holds for `preswitch`, which is executed before the switch +takes place, and `postsave`, which is executed after a profile was +stored/altered. + +All scripts can also be placed in any of the `$XDG_CONFIG_DIRS`. In addition to +the script names themselves, any executables in subdirectories named +`script_name.d` (e.g. `postswitch.d`) are executed as well. In scripts, some of +autorandr's state is exposed as environment variables prefixed with `AUTORANDR_`. +The most useful one is `$AUTORANDR_CURRENT_PROFILE`. + +## Apply configuration on login +With recent version you typically do not need to add autorandr to `~/.xprofile`, since autostart config file will be added at `/etc/xdg/autostart/autorandr.desktop`. It will select appropriate profile automatically. + +However, if you need to customize this, you can always disable or modify it by placing alternative desktop file in `~/.config/autostart` or using GUI like `gnome-session-properties`.