Initial commit: monitor-lets-go — automatic monitor layout daemon

2026-06-22 16:22:47 +07:00
commit a4b80616bb
13 changed files with 1708 additions and 0 deletions
@@ -0,0 +1,76 @@
+# monitor-lets-go example configuration
+# Copy to ~/.config/monitor-lets-go/config.yaml and adjust for your hardware.
+
+# Backend selection: "auto" (recommended), "hyprland", or "sway" (future).
+backend: auto
+
+# Quiet period after the last hotplug event before re-evaluating.
+# Docking stations fire multiple events; debounce coalesces them.
+debounce: 1200ms
+
+# Polling fallback interval. The daemon listens for compositor events
+# but also polls as a safety net. Set to 0 to disable polling.
+poll_interval: 5s
+
+# Whether to restore the portable layout when the daemon shuts down.
+restore_on_exit: true
+
+# External monitors that trigger docked mode.
+#   Plain name: matches the connector name (e.g. DP-1, HDMI-A-1).
+#   desc: prefix: matches by monitor description (survives rename).
+external:
+  - DP-1
+  - DP-2
+  - desc:Dell Inc. DELL U2723QE
+
+# Monitor layouts for each mode.
+# "portable" and "docked" are required.
+# Each mode lists monitors with their desired configuration.
+#
+# Fields:
+#   name     — connector name or desc:description
+#   enabled  — true to show, false to disable
+#   mode     — "preferred" (auto-detect), "1920x1080@60", etc.
+#   position — "auto", "0x0", "1920x0", etc.
+#   scale    — 1, 1.5, 2, etc.
+
+modes:
+  portable:
+    monitors:
+      - name: eDP-1
+        enabled: true
+        mode: preferred
+        position: "0x0"
+        scale: 1.0
+
+  docked:
+    monitors:
+      - name: DP-1
+        enabled: true
+        mode: "2560x1440@144"
+        position: "0x0"
+        scale: 1.0
+      - name: DP-2
+        enabled: true
+        mode: "2560x1440@144"
+        position: "2560x0"
+        scale: 1.0
+      - name: eDP-1
+        enabled: false
+      - name: desc:Dell Inc. DELL U2723QE
+        enabled: true
+        mode: "3840x2160@60"
+        position: "0x0"
+        scale: 1.5
+
+# Shell commands run after a layout change.
+# Commands run concurrently; failures are logged but never crash the daemon.
+# Tildes (~) and $HOME are expanded.
+hooks:
+  on_dock:
+    - "systemctl --user restart waybar"
+    - "~/.config/monitor-lets-go/on-dock.sh"
+
+  on_undock:
+    - "systemctl --user restart waybar"
+    - "~/.config/monitor-lets-go/on-undock.sh"