|AUTORANDR(1)||Automatically change screen layout||AUTORANDR(1)|
NAME¶autorandr - Automatically change screen layout
-s, --save <profile>
-r, --remove <profile>
-l, --load <profile>
-d, --default <profile>
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:
- Clone all connected outputs at the largest common resolution
- Clone all connected outputs with the largest resolution (scaled down if necessary)
- Stack all connected outputs horizontally at their largest resolution
- Stack all connected outputs vertically at their largest resolution
EXAMPLES¶# 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
AUTHORS¶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|