code
Open Source

macrig

Menu-bar controller for multi-Mac Jump Desktop rigs

One-click session launch, network-adaptive quality profiles, and dock-aware remote resolution switching for driving remote Macs from one machine.

menu bar
Wi-Fi●M14:32
Open All Sessions
Auto
High
Medium
Low
miniconnected
airconnected

○ no profile · ●H high · ●M medium · ●L low · ●! last action failed

What you get

One-click sessions

Open every saved Jump Desktop connection at once. The app drives Jump's own menus through Accessibility automation, so saved Fluid connections launch reliably.

Network-adaptive quality

High, medium, and low profiles tuned for the current connection. Auto mode watches network changes and re-tunes after a 12-second debounce.

Dock-aware resolution

When the viewer Mac docks or undocks, the remote resolution follows through BetterDisplay, so the far screen always matches the near one.

Menu-bar status

A compact glyph shows the active profile at a glance, with a distinct mark when the last action failed and a later success clears it.

Install

From source

$ cp config.example.sh config.sh
$ $EDITOR config.sh
$ bash install.sh

After first launch, approve the macOS Accessibility prompt. MacRig needs it to drive Jump Desktop's menus.

Requirements

  • macOS 13 or later on the viewer Mac
  • Jump Desktop with saved connections for each remote Mac
  • Jump Desktop Connect and BetterDisplay (with CLI) on each remote Mac
  • SSH key authentication from the viewer to the remotes
  • Tailscale (optional, for away-from-home access)

How it works

1

The menu-bar app shells out to shell scripts for every action, so everything it does can also run from a terminal

2

Accessibility automation drives Jump Desktop's File, Window, and Remote menus, since jump:// URLs are unreliable for saved Fluid connections

3

NWPathMonitor watches the viewer Mac's network and applies the matching quality profile after a 12-second debounce

4

BetterDisplay's CLI on each remote Mac switches resolution recipes when the viewer docks or undocks