Monitor Setup Utility.

Convenient wrapper over xrandr for setting up monitors

Monitor Setup Utility

ARandR is great for setting up monitors in a minimal way. I use it when plugging in at some random location and/or to save scripts to set things to a known configuration.

By contrast, this tool allows me to run a single command, with no options or thought (e.g. from a udev hot-plug rule), and have that tool figure out where I am and what saved-script (or literal command) to execute to configure my monitors.

Plugging into my office dock, like I do every morning? The script notes that I'm on my home wifi and a specific Display is now connected and it does the Right Thing.

Unplugging to only my laptop screen connected? This script sees this and resets to it as the single primary display.

Usage

Create a configuration file that defines how to match a "context" and what command to execute if matched:

~/.monitors.yaml:

- name: none
  match:
    # Only our primary display is connected
    displays:
      connected:
        eq:
          - eDP1

  # Turn everything else off and turn that on
  exec:
    xrandr
      --output eDP1 --primary --mode 2560x1440
      --output DP1 --off
      --output DP2 --off
      --output DP2-1 --off
      --output DP2-2 --off
      --output DP2-3 --off
      --output HDMI1 --off
      --output HDMI2 --off
      --output VIRTUAL1 --off

- name: home-dual
  match:
    # My second display is connected
    displays:
      connected:
        eq:
          - eDP1
          - DP2-2

    # And I'm on one of my home wifi networks
    wifi:
      essid:
        in:
          - pb-and-j
          - pb-and-j-5g

  # Set up those two displays how I like
  exec:
    xrandr
      --output eDP1 --mode 2560x1440 --right-of DP2-2
      --output DP1 --off
      --output DP2 --off
      --output DP2-1 --off
      --output DP2-2 --primary --mode 2560x1440
      --output DP2-3 --off
      --output HDMI1 --off
      --output HDMI2 --off
      --output VIRTUAL1 --off

Then run:

msu

CHANGELOG | LICENSE.