Skip to content

Auto-detect the connect display hardware and load the appropiate X11 setup using xrandr or disper

Notifications You must be signed in to change notification settings

nalipaz/autorandr

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

autorandr

Automatically select a display configuration based on connected devices.
This fork is a version of the original bash project. It cleans up some things and restructures so that it can be built as a debian package using equivs. - Nicholas

Stefan Tomanek [email protected]
Packaged by Nicholas Alipaz [email protected]

Installation

Just grab the latest .deb file from the [releases page](https://github.com/nalipaz/autorandr/releases/] and run:

sudo dpkg -i [file]

Alternatively, you can build this project by using the latest code in master and the debian package equivs.

git clone [this repo]
cd autorandr
equivs-build -f autorandr
sudo dpkg -i autorandr*.deb

How to use

Save your current display configuration and setup with:

autorandr --save mobile

Connect an additional display, configure your setup and save it:

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 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.

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>

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" utility, which is useful for controlling nvidia chipsets. The formats for fingerprinting the current setup and saving/loading the current configuration are adjusted accordingly.

About

Auto-detect the connect display hardware and load the appropiate X11 setup using xrandr or disper

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%