mymonitorsetup

Multi-monitor setup manager with custom profiles.

It supports changing your X server's display settings and the Gnome dashtopanel extension's settings as well.

Usage

Just assign a keyboard shortcut to the command mymonitorsetup and then you will be able to switch easily between monitor setups defined in /etc/mymonitorsetup/profiles.ini.

Config example (for two monitors)

[DEFAULT]

window-width = 400    # profile switcher window's width in pixels
window-height = 690   # profile switcher window's height in pixels

[exampleprofilename]
	# these are dashtopanel's settings
	dashtopanel-multi-monitors = true
	dashtopanel-primary-monitor = 1
	dashtopanel-show-showdesktop-hover = true
	dashtopanel-stockgs-keep-top-panel = false
	dashtopanel-stockgs-keep-dash = false
	dashtopanel-group-apps-label-max-width = 80

	output[0] = eDP-1      # the first monitor's device-name
	mode[0] = 1920x1080    # the first monitor's resolution
	pos[0] = 1280x400      # the first monitor's position
	primary[0] =           # set as default monitor

	output[1] = DP-1       # same but for the second monitor
	mode[1] = 1280x1024    # same but for the second monitor
	pos[1] = 0x0           # same but for the second monitor

You can find a full list of available settings for dashtopanel by executing dconf list /org/gnome/shell/extensions/dash-to-panel/.

This script using xrandr to apply the changes, therefore every monitor settings given in the config are exactly the same as the xrandr options. For these options see man xrandr.

Installation

• You can either download and install the deb package or use the source code and setup it yourself.

• If you wish, you can install it from my apt repository too:

  sudo echo "deb [signed-by=/usr/share/keyrings/ptamas-pub.gpg] http://apt.ptamas.hu/main/ ./" > /etc/apt/sources.list.d/apt.ptamas.list
  wget -qO - https://apt.ptamas.hu/ptamas-pub.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/ptamas-pub.gpg > /dev/null
  apt update && apt install mymonitorsetup