X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=README.md;h=fdfb54712d3c77d4515aadd5e809dc6e5b41f5e3;hb=53f7af43c6e0d597ebe7836c2d9aab94cc5d28d3;hp=f6a5bdb144c8519234ab133c19344dc817c524ab;hpb=3401494b339a79478d656f1ddcbe2bc963339ae6;p=deb_pkgs%2Fautorandr.git diff --git a/README.md b/README.md index f6a5bdb..fdfb547 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,63 @@ -# Tool: autorandr - +# autorandr Automatically select a display configuration based on connected devices -### Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)> +## Branch information + +This is a compatible Python rewrite of +[wertarbyte/autorandr](https://github.com/wertarbyte/autorandr). + +The original [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr) +tree is unmaintained, with lots of open pull requests and issues. I forked it +and merged what I thought were the most important changes. If you are searching +for that version, see the [`legacy` branch](https://github.com/phillipberndt/autorandr/tree/legacy). +Note that the Python version is better suited for non-standard configurations, +like if you use `--transform` or `--reflect`. If you use `auto-disper`, you +have to use the bash version, as there is no disper support in the Python +version (yet). Both versions use a compatible configuration file format, so +you can, to some extent, switch between them. I will maintain the `legacy` +branch until @wertarbyte finds the time to maintain his branch again. + +If you are interested in why there are two versions around, see +[#7](https://github.com/phillipberndt/autorandr/issues/7), +[#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 +version. + +## License information and authors + +autorandr is available under the terms of the GNU General Public License +(version 3). + +Contributors to this version of autorandr are: -# How to use: +* Alexander Wirt +* Chris Dunder +* Daniel Hahler +* Maciej Sitarz +* Matthew R Johnson +* Phillip Berndt +* Rasmus Wriedt Larsen +* Stefan Tomanek +* Timo Bingmann +* Tomasz Bogdal +* Victor Häggqvist +* stormc +* tachylatus +* andersonjacob + +## How to use Save your current display configuration and setup with: -```autorandr --save mobile``` +``` +autorandr --save mobile +``` Connect an additional display, configure your setup and save it: -```autorandr --save docked``` +``` +autorandr --save docked +``` Now autorandr can detect which hardware setup is active: ``` @@ -36,12 +83,8 @@ 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 +`~/.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. - -While the script uses xrandr by default, calling it by the name __autodisper__ -or "auto-disper" forces it to use the "disper" utility, which is useful for -controlling nvidia chipsets. The formats for fingerprinting the current setup -and saving/loading the current configuration are adjusted accordingly. +To install autorandr call `make install`.