Switching the display quickly between a laptop monitor and an external monitor or projector in Linux
April 3, 2013 Leave a comment
I connect my laptop to an external keyboard and an external monitor or projector in various offices and at home, and each of the monitors has a different resolution. Fn-F3 on my laptop keyboard allows me to toggle between monitors, but I want more control (including the ability to specify the resolution of the external display). Now, I find the GPU manufacturer’s application and the Desktop Environment’s GUI for switching monitors and changing screen resolution rather cumbersome, so I wanted an icon on the Desktop that I could double-click to switch monitors without having to enter the root user’s password and fiddle around too much. So I decided to create some simple Bash scripts and associated Desktop Config files with nice-looking icons on the desktop, which I can launch easily and quickly by double-clicking. Obviously the resolutions are limited to the range of resolutions supported by the GPU and external monitor.
The suite of Desktop Config files I created have self-explanatory names:
$ cd ~/Desktop
$ ls -1 Switch*
Switch_OFF_laptop_monitor_if_external_monitor_is_connected
Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto
Switch_ON_laptop_monitor_and_external_monitor
Switch_ON_laptop_monitor_and_switch_off_external_monitor
$ ls -1 Toggle*
Toggle_display
The difference between Switch_OFF_laptop_monitor_if_external_monitor_is_connected and Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto is that the former prompts for the resolution of the external monitor whereas the latter tries to find the resolution automatically. I have both because I have found that, for some external display devices (e.g. projectors), it is handy to have the ability to specify the resolution manually.
Switch off the laptop monitor if an external monitor is connected (find resolution automatically)
The Desktop Config file I double-click the most is ~/Desktop/Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto, and it contains the following text:
[Desktop Entry] Comment[en_GB]=switch off laptop monitor if external monitor is connected auto Comment=switch off laptop monitor if external monitor is connected auto Exec=sh /home/fitzcarraldo/switch_off_laptop_monitor_if_external_monitor_is_connected_auto.sh GenericName[en_GB]=Switch off laptop monitor if external monitor is connected auto GenericName=Switch off laptop monitor if external monitor is connected auto Icon=/home/fitzcarraldo/Pictures/Icons/display.png MimeType= Name[en_GB]=Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto Name=Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto Path= StartupNotify=true Terminal=false TerminalOptions= Type=Application X-DBUS-ServiceName= X-DBUS-StartupType=none X-KDE-SubstituteUID=false X-KDE-Username=
The Bash script it launches, ~/switch_off_laptop_monitor_if_external_monitor_is_connected_auto.sh, contains the following code:
#!/bin/bash if xrandr -q | grep "CRT1 connected"; then xrandr --output LVDS --off xrandr --output CRT1 --off xrandr --output CRT1 --auto else xrandr --output CRT1 --off xrandr --output LVDS --off xrandr --output LVDS --mode 1920x1080 # 1920x1080 is the native resolution of my laptop monitor fi
Don’t forget to make them executable:
$ chmod +x /home/fitzcarraldo/Desktop/Switch_OFF_laptop_monitor_if_external_monitor_is_connected_auto
$ chmod +x /home/fitzcarraldo/switch_off_laptop_monitor_if_external_monitor_is_connected_auto.sh
If you’re wondering how I knew I had to specify ‘CRT1′ and ‘LVDS’ in the Bash script, I used the xrandr command to find out what names the GPU gives the monitors:
$ xrandr
Screen 0: minimum 320 x 200, current 1920 x 1080, maximum 1920 x 1920
LVDS connected (normal left inverted right x axis y axis)
1920x1080 60.0 +
1680x1050 60.0
1400x1050 60.0
1600x900 60.0
1280x1024 60.0
1440x900 60.0
1280x960 60.0
1280x768 60.0
1280x720 60.0
1024x768 60.0
1024x600 60.0
800x600 60.0
800x480 60.0
640x480 60.0
DFP1 disconnected (normal left inverted right x axis y axis)
CRT1 connected 1920x1080+0+0 (normal left inverted right x axis y axis) 476mm x 268mm
1920x1080 60.0*+
1280x1024 75.0 60.0
1280x960 60.0
1280x800 59.8
1152x864 75.0
1280x720 60.0
1024x768 75.0 70.1 60.0
800x600 72.2 75.0 60.3 56.2
640x480 75.0 72.8 67.0 59.9
Switch off the laptop monitor if an external monitor is connected (enter resolution)
The Desktop Config file I double-click is ~/Desktop/Switch_OFF_laptop_monitor_if_external_monitor_is_connected, and it contains the following text:
[Desktop Entry] Comment[en_GB]=switch off laptop monitor if external monitor is connected Comment=switch off laptop monitor if external monitor is connected Exec=sh /home/fitzcarraldo/System_Administration/switch_off_laptop_monitor_if_external_monitor_is_connected.sh GenericName[en_GB]=Switch off laptop monitor if external monitor is connected GenericName=Switch off laptop monitor if external monitor is connected Icon=/home/fitzcarraldo/Pictures/Icons/display.png MimeType= Name[en_GB]=Switch_OFF_laptop_monitor_if_external_monitor_is_connected Name=Switch_OFF_laptop_monitor_if_external_monitor_is_connected Path= StartupNotify=true Terminal=true TerminalOptions= Type=Application X-DBUS-ServiceName= X-DBUS-StartupType=none X-KDE-SubstituteUID=false X-KDE-Username=
The Bash script it launches, ~/switch_off_laptop_monitor_if_external_monitor_is_connected.sh, contains the following code:
#!/bin/bash if xrandr -q | grep "CRT1 connected"; then echo -n "Enter resolution width of external monitor (hint 1920 Doha, 1440 home): " read EXTERNAL_WIDTH echo -n "Enter resoluton height of external monitor (hint 1080 Doha, 900 home): " read EXTERNAL_HEIGHT xrandr --output LVDS --off xrandr --output CRT1 --off xrandr --output CRT1 --mode $EXTERNAL_WIDTH"x"$EXTERNAL_HEIGHT else xrandr --output CRT1 --off xrandr --output LVDS --off xrandr --output LVDS --mode 1920x1080 # 1920x1080 is the native resolution of my laptop monitor fi
Don’t forget to make them executable:
$ chmod +x /home/fitzcarraldo/Desktop/Switch_OFF_laptop_monitor_if_external_monitor_is_connected
$ chmod +x /home/fitzcarraldo/switch_off_laptop_monitor_if_external_monitor_is_connected.sh
Switch on the laptop monitor and external monitor simultaneously
I don’t need to use this one much, only when I am using an external monitor but suddenly want to use the laptop’s built-in Webcam and so have to open fully the laptop’s lid. The file ~/Desktop/Switch_ON_laptop_monitor_and_external_monitor contains the following text:
[Desktop Entry] Comment[en_GB]=switch_ON_laptop_monitor_and_external_monitor Comment=switch_ON_laptop_monitor_and_external_monitor Exec=sh /home/fitzcarraldo/switch_on_laptop_monitor_and_external_monitor.sh GenericName[en_GB]=Switch_ON_laptop_monitor_and_external_monitor GenericName=Switch_ON_laptop_monitor_and_external_monitor Icon=/home/fitzcarraldo/Pictures/Icons/display.png MimeType= Name[en_GB]=Switch_ON_laptop_monitor_and_external_monitor Name=Switch_ON_laptop_monitor_and_external_monitor Path= StartupNotify=true Terminal=true TerminalOptions= Type=Application X-DBUS-ServiceName= X-DBUS-StartupType=none X-KDE-SubstituteUID=false X-KDE-Username=
and the Bash script it calls, ~/switch_on_laptop_monitor_and_external_monitor.sh, contains the following code:
#!/bin/bash if xrandr -q | grep "CRT1 connected"; then echo "Note that the resolution specified must be the same for both monitors, and must be achievable on both monitors." echo -n "Enter resolution width of external monitor (hint 1920 office, 1440 home): " read EXTERNAL_WIDTH echo -n "Enter resoluton height of external monitor (hint 1080 office, 900 home): " read EXTERNAL_HEIGHT #xrandr --output LVDS --off xrandr --output LVDS --mode $EXTERNAL_WIDTH"x"$EXTERNAL_HEIGHT xrandr --output CRT1 --off xrandr --output CRT1 --mode $EXTERNAL_WIDTH"x"$EXTERNAL_HEIGHT else xrandr --output CRT1 --off xrandr --output LVDS --off xrandr --output LVDS --mode 1920x1080 # 1920x1080 is the native resolution of my laptop monitor fi
Don’t forget to make them executable:
$ chmod +x /home/fitzcarraldo/Desktop/Switch_ON_laptop_monitor_and_external_monitor
$ chmod +x /home/fitzcarraldo/switch_on_laptop_monitor_and_external_monitor.sh
Switch on the laptop monitor and switch off an external monitor
I don’t need to use this one much either, given that the display mode reverts to the laptop monitor after I reboot or shutdown/power-up the laptop. The file ~/Desktop/Switch_ON_laptop_monitor_and_external_monitor contains the following text:
[Desktop Entry] Comment[en_GB]=switch on laptop monitor and switch off external monitor Comment=switch on laptop monitor and switch off external monitor Exec=sh /home/fitzcarraldo/switch_on_laptop_monitor_and_switch_off_external_monitor.sh GenericName[en_GB]=Switch on laptop monitor and switch off external monitor GenericName=Switch on laptop monitor and switch off external monitor Icon=computer-laptop MimeType= Name[en_GB]=Switch_ON_laptop_monitor_and_switch_off_external_monitor Name=Switch_ON_laptop_monitor_and_switch_off_external_monitor Path= StartupNotify=true Terminal=false TerminalOptions= Type=Application X-DBUS-ServiceName= X-DBUS-StartupType= X-KDE-SubstituteUID=false X-KDE-Username=
The Bash script it launches, ~/switch_on_laptop_monitor_and_switch_off_external_monitor.sh, contains the following code:
#!/bin/bash xrandr --output CRT1 --off xrandr --output LVDS --auto xrandr --output LVDS --mode 1920x1080 # 1920x1080 is the native resolution of my laptop monitor
I did also create a fifth Desktop Config file and associated Bash script, to toggle between the three modes (laptop monitor only > both monitors > external monitor only) rather than having to double-click three different icons. But, to be honest, it’s quicker and easier to have the three icons and double-click on the one I want rather than toggling through three display modes. Anyway, in case you are interested, the Desktop Config file ~/Desktop/Toggle_Display contains the follow text:
[Desktop Entry] Comment[en_GB]=Toggle between laptop monitor, external monitor and both Comment=Toggle between laptop monitor, external monitor and both Exec=sh /home/fitzcarraldo/toggle_display.sh GenericName[en_GB]=Toggle between laptop monitor, external monitor and both GenericName=Toggle between laptop monitor, external monitor and both Icon=video-display MimeType= Name[en_GB]=Toggle_display Name=Toggle_display Path= StartupNotify=false Terminal=false TerminalOptions= Type=Application X-DBUS-ServiceName= X-DBUS-StartupType=none X-KDE-SubstituteUID=false X-KDE-Username=
and the Bash script it launches, ~/switch_on_laptop_monitor_and_external_monitor.sh, contains the following code:
#!/bin/sh
# Using the xrandr command I found that the two video outputs from my laptop are named LVDS
# (the internal display) and CRT1 (the external display driven by the laptop's VGA socket).
# My external monitor at home has a resolution of 1440x900.
CONNECTED=`xrandr | grep -i ' connected' | grep LVDS | awk '{print $1}'`
CONNECTED="${CONNECTED} `xrandr | grep -i ' connected' | grep CRT | awk '{print $1}'`"
ENABLED=`awk '{print;exit}' ~/displays_enabled 2>/dev/null`
if [ "$CONNECTED" = "LVDS" -o "$CONNECTED" = "LVDS " -o "$CONNECTED" = " LVDS" ]; then
# Only the internal display is connected, so don't do anything.
echo "LVDS" > ~/displays_enabled
ENABLED="LVDS"
xrandr --output CRT1 --off
xrandr --output LVDS --off
xrandr --output LVDS --auto
exit 0
elif [ "$CONNECTED" = "LVDS CRT1" ]; then
# Both the internal and external displays are connected, so let's toggle
# LVDS > LVDS,CRT1 > CRT1
EXTERNALRES=`xrandr | awk 'c&&c--;/ connected/{c=1}' | awk '{print $1}' | grep 1440x900`
if [ "$ENABLED" = "LVDS" ]; then
# Switching on both displays.
xrandr --output LVDS --off
if [ "$EXTERNALRES" = "1440x900" ]; then
xrandr --output LVDS --mode 1440x900
xrandr --output CRT1 --off
xrandr --output CRT1 --auto
else
xrandr --output LVDS --auto
xrandr --output CRT1 --off
xrandr --output CRT1 --auto
fi
ENABLED="LVDS CRT1"
echo "LVDS CRT1" > ~/displays_enabled
elif [ "$ENABLED" = "LVDS CRT1" ]; then
# Switching on only external display.
xrandr --output LVDS --off
xrandr --output CRT1 --off
xrandr --output CRT1 --auto
ENABLED="CRT1"
echo "CRT1" > ~/displays_enabled
else
# Switching on only internal display.
xrandr --output CRT1 --off
xrandr --output LVDS --off
xrandr --output LVDS --auto
ENABLED="LVDS"
echo "LVDS" > ~/displays_enabled
fi
fi
As I use KDE, I also used System Settings > Shortcuts and Gestures | Custom Shortcuts to create a keyboard shortcut which I named ‘Toggle display’, with Meta+P as Trigger and sh ~/toggle_display.sh as Action, but I tend to use the mouse rather than the keyboard in any case.
By the way, you might think some of the xrandr commands in the above Bash scripts are redundant. You would be correct in thinking that, but in practice I found that the displays did not switch if I didn’t include the additional commands shown (due to a bug in xrandr, perhaps?). Even then, when I switch to an external monitor, occasionally the screen resolution is slightly too big or too small, so I placed the icons at the top left of the desktop so that they are always accessible and I can just double-click on the same icon again if necessary. As I’m using KDE, I placed a Folder View Plasmoid for ~/Desktop/ at the top left of the desktop, as you can see in the screenshot.
Footnote
I’ve been using the above method of switching between displays for a couple of years now with an AMD ATI GPU. It works nicely and suits my needs perfectly. AMD has supported xrandr since 2008 (see Ref. 1), whereas NVIDIA only began to support xrandr last year (see Ref. 2) so I’m not sure how well these scripts would work with NVIDIA GPUs.
Ref. 1: AMD Catalyst 8.9 Gets WINE Fix, RandR 1.2 Support, September 18, 2008
Ref. 2: NVIDIA’s 302 Linux Driver Finally Has RandR 1.2/1.3, May 2, 2012
