Omahub
← All plugins
C

hyprmoncfg: Multi-Monitor Manager for Omarchy

by Carmine Paolino

Create multi-monitor layouts in a visual editor and switch them automatically on hotplug and lid events.

Install
$ omarchy plugin add https://github.com/crmne/omarchy-hyprmoncfg --enable
Hardware #Hyprland #bar #quickshell

hyprmoncfg: Multi-Monitor Manager for Omarchy

An Omarchy bar panel for hyprmoncfg. Create multi-monitor layouts for Hyprland in a visual editor and switch them automatically on hotplug and lid events. See the live display layout and active profile in the bar, or hand display management cleanly back to Omarchy.

hyprmoncfg for Omarchy

The panel is intentionally the full hyprmoncfg experience: it installs the stable AUR package, enables the user daemon, and uses automatic switching on monitor hotplug.

Install

omarchy plugin add https://github.com/crmne/omarchy-hyprmoncfg.git --enable

If hyprmoncfg is missing, open the panel and choose Install hyprmoncfg. Omarchy opens its normal presented terminal and runs:

omarchy pkg aur add hyprmoncfg && systemctl --user enable --now hyprmoncfgd.service && setsid -f gtk-launch hyprmoncfg-omarchy >/dev/null 2>&1

The installer opens hyprmoncfg through its hidden Omarchy desktop launcher after starting the daemon. That launcher ships with the main package and carries Omarchy's standard TUI.float window identity, so the editor opens centered at the normal floating size without putting Omarchy-specific window logic in the panel. Saving a profile updates the panel immediately over IPC. The plugin never runs yay or requests privileges invisibly inside omarchy-shell.

Requirements

  • Omarchy Quattro with third-party shell plugins
  • hyprmoncfg 1.12.0 or newer (installed from the panel when missing)

Remove

omarchy plugin remove crmne.hyprmoncfg

Removing the plugin leaves hyprmoncfg and its saved profiles in place. To stop automatic switching first, turn off Managed by hyprmoncfg in the panel. Remove the AUR package separately only if you no longer use hyprmoncfg.

Development

omarchy plugin validate .
node --test tests/model.test.js