AUTORANDR(1) | Automatically change screen layout | AUTORANDR(1) |
autorandr - Automatically change screen layout
autorandr [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
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.
The following virtual configurations are available:
# save the current setup and set default
autorandr --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
Autorandr is written and maintained by Phillip Berndt, with contributions by many others. See https://github.com/phillipberndt/autorandr for more information.
October 2017 | autorandr 1.2 |