table of contents
AUTORANDR(1) | Automatically change screen layout | AUTORANDR(1) |
NAME¶
autorandr - Automatically change screen layoutSYNOPSIS¶
autorandr [options]OPTIONS¶
-h, --help-c, --change
-s, --save <profile>
-r, --remove <profile>
-l, --load <profile>
-d, --default <profile>
--skip-options <option>
--force
--fingerprint
--config
--dry-run
--debug
--batch
CONFIGURATION¶
To prevent a profile from being loaded, place a script called "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>.
Another script called "postswitch" can be placed in the directory ~/.config/autorandr (or ~/.autorandr if you have an old installation) as well as in any profile directories: The scripts are executed after a mode switch has taken place and can notify window managers.
VIRTUAL CONFIGURATIONS¶
The following virtual configurations are available:- common
- Clone all connected outputs at the largest common resolution
- clone-largest
- Clone all connected outputs with the largest resolution (scaled down if necessary)
- horizontal
- Stack all connected outputs horizontally at their largest resolution
- vertical
- Stack all connected outputs vertically at their largest resolution
EXAMPLES¶
# save the current setup and set defaultautorandr --save mysetup
echo -e '[config]\ndefault=mysetup' > ~/.config/autorandr/settings.ini
# put laptop in dock (or plug in additional monitors)
# run appropriate xrandr commands to fix things up
autorandr --save docked_setup
# now remove the laptop from the dock, and settings return to mysetup
AUTHORS¶
Autorandr is written and maintained by Phillip Berndt, with contributions by many others. See https://github.com/phillipberndt/autorandr for more information.SEE ALSO¶
xrandr(1)October 2017 | autorandr 1.2 |