RepoMirrors/autorandr
1
0
Fork 0
mirror of https://github.com/phillipberndt/autorandr synced 2025-02-18 04:26:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'mtahmed/master'

Browse Source 
Conflicts:
	README.md
This commit is contained in:
Phillip Berndt 2013-11-29 07:58:56 +01:00
commit 399523da9b
1 changed files with 30 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
README → README.md
View File

@ -1,5 +1,10 @@
BRANCH INFORMATION
------------------
# autorandr
Automatically select a display configuration based on connected devices
Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)>
## Branch information
The original wertarbyte/autorandr tree seems unmaintained, with lots of open
pull requests and issues. I forked it and merged what I thought were the most
@ -7,56 +12,51 @@ important changes. I will maintain this branch until wertarbyte finds the time
to maintain his branch again.
ORIGINAL README
---------------
Tool: "autorandr"
Automatically select a display configuration based on connected devices
Stefan Tomanek <stefan.tomanek@wertarbyte.de>
How to use:
## 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:
```
$ autorandr
mobile
docked (detected)
```
To automatically reload your setup, just append --change to the command line
To automatically reload your setup, just append `--change` to the command line
To manually load a profile, you can use the --load <profile> option.
To manually load a profile, you can use the `--load <profile>` option.
autorandr tries to avoid reloading an identical configuration. To force the
(re)configuration, apply --force.
(re)configuration, apply `--force`.
To prevent a profile from being loaded, place a script call "block" in its
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
in case of it returning a value of 0 the profile is skipped. This can be used
to query the status of a docking station you are about to leave.
If no suitable profile can be identified, the current configuration is kept.
To change this behaviour and switch to a fallback configuration, specify
--default <profile>
`--default <profile>`.
Another script called "postswitch "can be placed in the directory
~/.autorandr as well as in all profile directories: The scripts are executed
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.
While the script uses xrandr by default, calling it by the name `autodisper`
or `auto-disper` forces it to use the [disper](http://willem.engen.nl/projects/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.
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", define your setup and then call
"make hotplug" to install hotplug scripts.
To install autorandr call `make install`, define your setup and then call
`make hotplug` to install hotplug scripts.