3 # Automatically select a display configuration based on connected devives
5 # Stefan Tomanek <stefan.tomanek@wertarbyte.de>
9 # Save your current display configuration and setup with:
10 # $ autorandr --save mobile
12 # Connect an additional display, configure your setup and save it:
13 # $ autorandr --save docked
15 # Now autorandr can detect which hardware setup is active:
20 # To automatically reload your setup, just append --change to the command line
22 # To manually load a profile, you can use the --load <profile> option.
24 # autorandr tries to avoid reloading an identical configuration. To force the
25 # (re)configuration, apply --force.
27 # To prevent a profile from being loaded, place a script call "block" in its
28 # directory. The script is evaluated before the screen setup is inspected, and
29 # in case of it returning a value of 0 the profile is skipped. This can be used
30 # to query the status of a docking station you are about to leave.
32 # If no suitable profile can be identified, the current configuration is kept.
33 # To change this behaviour and switch to a fallback configuration, specify
36 # Another script called "postswitch "can be placed in the directory
37 # ~/.autorandr as well as in all profile directories: The scripts are executed
38 # after a mode switch has taken place and can notify window managers or other
39 # applications about it.
42 # While the script uses xrandr by defult, calling it by the name "autodisper"
43 # or "auto-disper" forces it to use the "disper" utility, which is useful for
44 # controlling nvidia chipsets. The formats for fingerprinting the current setup
45 # and saving/loading the current configuration are adjusted accordingly.
47 XRANDR=/usr/bin/xrandr
48 DISPER=/usr/bin/disper
49 PROFILES=~/.autorandr/
50 CONFIG=~/.autorandr.conf
57 FP_METHODS="setup_fp_xrandr_edid setup_fp_sysfs_edid"
58 CURRENT_CFG_METHOD="current_cfg_xrandr"
59 LOAD_METHOD="load_cfg_xrandr"
61 SCRIPTNAME="$(basename $0)"
62 # when called as autodisper/auto-disper, we assume different defaults
63 if [ "$SCRIPTNAME" = "auto-disper" ] || [ "$SCRIPTNAME" = "autodisper" ]; then
64 echo "Assuming disper defaults..." >&2
65 FP_METHODS="setup_fp_disper"
66 CURRENT_CFG_METHOD="current_cfg_disper"
67 LOAD_METHOD="load_cfg_disper"
70 if [ -f $CONFIG ]; then
71 echo "Loading configuration from '$CONFIG'" >&2
75 setup_fp_xrandr_edid() {
76 $XRANDR -q --verbose | awk '
77 /^[^ ]+ (dis)?connected / { DEV=$1; }
78 $1 ~ /^[a-f0-9]+$/ { ID[DEV] = ID[DEV] $1 }
79 END { for (X in ID) { print X " " ID[X]; } }'
82 setup_fp_sysfs_edid() {
83 # xrandr triggers the reloading of EDID data
84 $XRANDR -q > /dev/null
85 # hash the EDIDs of all _connected_ devices
86 for P in /sys/class/drm/card*-*/; do
88 [ ! -d "$P" ] && continue
89 if grep -q "^connected$" < "${P}status"; then
90 echo -n "$(basename "$P") "
91 md5sum ${P}edid | awk '{print $1}'
97 $DISPER -l | grep '^display '
102 for M in $FP_METHODS; do
104 if [ -n "$FP" ]; then
108 if [ -z "$FP" ]; then
109 echo "Unable to fingerprint display configuration" >&2
115 current_cfg_xrandr() {
116 local PRIMARY_SETUP=$(xdpyinfo -ext XINERAMA|awk '/^ head #0:/ {printf $3 $5}')
117 $XRANDR -q | awk -v primary_setup=${PRIMARY_SETUP} '
118 # display is connected and has a mode
119 /^[^ ]+ connected [^(]/ {
123 print "pos "A[2]"x"A[3];
124 if (A[1] A[2] "," A[3] == primary_setup)
128 # disconnected or disabled displays
129 /^[^ ]+ (dis)?connected / {
136 current_cfg_disper() {
146 [ ! -x "$PROFILES/$PROFILE/block" ] && return 1
148 "$PROFILES/$PROFILE/block" "$PROFILE"
153 if [ "$(cat "$PROFILES/$PROFILE/config")" = "$(current_cfg)" ]; then
154 echo "Config already loaded"
162 sed 's!^!--!' "$1" | xargs $XRANDR
171 local CONF="$PROFILES/$PROFILE/config"
172 if [ -e "$CONF" ] ; then
173 echo " -> loading profile $PROFILE"
176 [ -x "$PROFILES/$PROFILE/postswitch" ] && \
177 "$PROFILES/$PROFILE/postswitch" "$PROFILE"
178 [ -x "$PROFILES/postswitch" ] && \
179 "$PROFILES/postswitch" "$PROFILE"
185 Usage: $SCRIPTNAME [options]
187 -h, --help get this small help
188 -c, --change reload current setup
189 -s, --save <profile> save your current setup to profile <profile>
190 -l, --load <profile> load profile <profile>
191 -d, --default <profile> make profile <profile> the default profile
192 --force force (re)loading of a profile
193 --fingerprint fingerprint your current hardware setup
195 To prevent a profile from being loaded, place a script call "block" in its
196 directory. The script is evaluated before the screen setup is inspected, and
197 in case of it returning a value of 0 the profile is skipped. This can be used
198 to query the status of a docking station you are about to leave.
200 If no suitable profile can be identified, the current configuration is kept.
201 To change this behaviour and switch to a fallback configuration, specify
204 Another script called "postswitch "can be placed in the directory
205 ~/.autorandr as well as in any profile directories: The scripts are executed
206 after a mode switch has taken place and can notify window managers.
208 When called by the name "autodisper" or "auto-disper", the script uses "disper"
209 instead of "xrandr" to detect, configure and save the display configuration.
215 OPTS=$(getopt -n autorandr -o s:l:d:cfh --long change,default:,save:,load:,force,fingerprint,help -- "$@")
216 if [ $? != 0 ] ; then echo "Terminating..." >&2 ; exit 1 ; fi
221 -c|--change) CHANGE_PROFILE=1; shift ;;
222 -d|--default) DEFAULT_PROFILE="$2"; shift 2 ;;
223 -s|--save) SAVE_PROFILE="$2"; shift 2 ;;
224 -l|--load) LOAD_PROFILE="$2"; shift 2 ;;
226 --force) FORCE_LOAD=1; shift ;;
227 --fingerprint) setup_fp; exit 0;;
229 *) echo "Error: $1"; exit 1;;
233 CURRENT_SETUP="$(setup_fp)"
235 if [ -n "$SAVE_PROFILE" ]; then
236 echo "Saving current configuration as profile '${SAVE_PROFILE}'"
237 mkdir -p "$PROFILES/$SAVE_PROFILE"
238 echo "$CURRENT_SETUP" > "$PROFILES/$SAVE_PROFILE/setup"
239 $CURRENT_CFG_METHOD > "$PROFILES/$SAVE_PROFILE/config"
243 if [ -n "$LOAD_PROFILE" ]; then
244 CHANGE_PROFILE=1 FORCE_LOAD=1 load "$LOAD_PROFILE"
248 for SETUP_FILE in $PROFILES/*/setup; do
249 if ! [ -e $SETUP_FILE ]; then
252 PROFILE="$(basename $(dirname "$SETUP_FILE"))"
255 if blocked "$PROFILE"; then
260 FILE_SETUP="$(cat "$PROFILES/$PROFILE/setup")"
261 if [ "$CURRENT_SETUP" = "$FILE_SETUP" ]; then
263 if [ "$CHANGE_PROFILE" -eq 1 ]; then
264 if [ "$FORCE_LOAD" -eq 1 ] || ! config_equal "$PROFILE"; then
268 # found the profile, exit with success
275 # we did not find the profile, load default
276 if [ -n "$DEFAULT_PROFILE" ]; then
277 echo "No suitable profile detected, falling back to $DEFAULT_PROFILE"
278 load "$DEFAULT_PROFILE"