Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v2.14.1 (2026-11-02), so it may lag behind newer releases.
Thanks. The report went to osfeed, and the line gets checked against the repository.
Arrange your monitors in a visual editor in the Omarchy bar, save a profile per setup, and have the right layout applied when you plug in displays or close the lid.
This page covers hyprmoncfg for Omarchy up to v2.14.1. GitHub has v2.16.0 (), not published here yet. Maintainer? Publish it with your agent.
What you can do with hyprmoncfg for Omarchy
Apply the saved monitor profile that matches the connected displays automatically on hotplug and lid events.
Since v1.1.5
Good to know
Needs the hyprmoncfg package and its hyprmoncfgd user service.
Install or update hyprmoncfg and restart its service from the panel.
Since v1.1.5
Good to know
Package switching is offered only for the source package and is hidden during edits, previews or service work. Replacement was tested with stub package-manager commands, not on the host's installed package.
Open the monitor editor from a custom menu while hiding its bar icon.
Since v2.10.0
Good to know
Keep the bar entry configured. Hidden icons have no numbered panel shortcut or Tab panel switching. Omarchy has no Display-menu extension slot; menu integration needs a user-owned customization.
Rotate a built-in display with a tablet or convertible and lock its current orientation.
Since v2.10.0
Good to know
Needs an orientation sensor, iio-sensor-proxy and backend calibration support. Sensor calibration and the Lock/Calibrate rows were not physically tested. hyprmoncfg 1.28.0 preserves upright rotation when leaving Auto.
Set terminal text size independently of the shell and GTK text size.
Since v2.10.0
Good to know
A later desktop Text size change also resizes terminal fonts. Foot applies the new size in new windows or after restart. This is live desktop state, not stored in profiles.
Install a monitor-ordered workspace picker and open its workspace-only planner from the bar.
Since v2.14.1
Good to know
The offer needs hyprmoncfg 1.26.0 and an applied workspace plan. Finish previews and save or discard edits before changing the bar. Existing picker installations can switch live workspaces with older daemons.
Use the panel in any of Omarchy's 50 languages and change its language without restarting.
Since v2.14.1
Good to know
Older Omarchy stays in English. Daemon messages and the widget name/settings in Omarchy lists stay in English. Translations have not had native-speaker review.
Switch a laptop and external display between Extend and Mirror with a confirmed preview.
Since v2.14.1
Good to know
Needs a built-in and external display. Extend remembers prior positions only for the current shell session. Release testing used synthetic displays and did not exercise physical mirroring or Keep.
Selectors replace rows with three or more choices. Advanced holds Flipped/Position/Place beside and colour calibration/overrides, summarizes non-default hidden values and stays closed until opened. Scale lists presets first, then other sharp scales, then Custom.
Behavior changedAffects: Users of the expanded display and colour inspectors
Single-display setups hide arrangement-only controls but retain rotation. Expand no longer jumps through a screen-tall frame. In 2.14.1, Flipped uses the surrounding fields' height and body-size label.
Behavior changedAffects: Users with one display or opening the expanded inspector
Fields read the clipboard only on `Ctrl+V` or `Shift+Insert`, capped at two seconds and 4096 bytes, as one line without control characters. Copy/Cut, right-click menus, word selection by dragging, input methods and compose sequences are unavailable.
Update hyprmoncfg to 1.24.0 or newer for panel 2.9.0 and later; 1.25.0 is recommended for sensor calibration, fixed-panel touch alignment and wake recovery.
Action requiredAffects: Users with hyprmoncfg older than 1.24.0
Use a versioned build; unversioned development builds no longer pass the minimum-version check. If an unknown daemon remains after `Restart daemon`, inspect `systemctl --user cat hyprmoncfgd` for a custom service path.
Action requiredAffects: Users running unversioned development builds of hyprmoncfg
v2.14.1 with v2.10.1, v2.11.0, v2.12.0, v2.13.0, v2.14.0
Manage your monitor workspace plan from a dedicated bar popup.
Details
The workspace picker opens the shared planner and setup controls; the inspector now uses selectors and Advanced rows. Profile actions add Rename, Auto rotation adds Calibrate, and the layout adds Extend/Mirror and a rotation menu.
Also: Live language switching, Extend/Mirror previews, profile renaming, rotation calibration, compact selectors, and fixes for runaway steppers and shell compatibility.
Panel v2.14.1; update with `omarchy plugin update crmne.hyprmoncfg`. Needs Omarchy Quattro and hyprmoncfg 1.24.0+; the picker offer needs 1.26.0, Rename 1.27.0, and calibration needs backend support.
Now works: Decide which Hyprland workspaces open on which moni…Added: Install a monitor-ordered workspace picker and open…Improved: Install or update hyprmoncfg and restart its servic…Now works: See the live arrangement of your monitors and which…Now works: Drag monitors into place and set each one's mode, s…Added: Use the panel in any of Omarchy's 50 languages and…Added: Switch a laptop and external display between Extend…Improved: Drag monitors into place and set each one's mode, s…Behavior changed: Decide which Hyprland workspaces open on which moni…Added: Rename a saved monitor profile from its actions men…Improved: Rotate a built-in display with a tablet or converti…Behavior changed: Drag monitors into place and set each one's mode, s…Behavior changed: Drag monitors into place and set each one's mode, s…Behavior changed: Drag monitors into place and set each one's mode, s…
Set terminal text size without changing shell or GTK text size.
Details
A Terminal slider controls Alacritty, Ghostty, Kitty and Foot; source-package users can switch to hyprmoncfg-bin. The editor adds Auto/Lock rotation, separate Resolution and Refresh controls, and Custom scale entry; fields read the clipboard only on explicit paste, with limits and reduced editing support.
Also: Hide the bar icon; use Auto rotation and Lock; choose resolution and refresh separately; type a custom scale; switch source installs to prebuilt packages.
Panel v2.10.0, grouping v2.8.0–v2.9.0; update through `omarchy plugin update crmne.hyprmoncfg`. Requires Omarchy Quattro and hyprmoncfg 1.24.0 or newer; 1.25.0 recommended.
Added: Open the monitor editor from a custom menu while hi…Improved: Drag monitors into place and set each one's mode, s…Now works: Drag monitors into place and set each one's mode, s…Behavior changedAdded: Rotate a built-in display with a tablet or converti…Added: Set terminal text size independently of the shell a…Improved: Install or update hyprmoncfg and restart its servic…Action requiredAction requiredBehavior changed: See the live arrangement of your monitors and which…
See which displays are on but show nothing, or run below their saved settings.
Details
v2.5.0 marks displays with No usable signal and shows when hyprmoncfg stepped a display down (needs hyprmoncfg 1.21.0). v2.6.0 redraws the layout as lit screens, sizes the panel to its content, adds scale pills, Place beside and layout thumbnails on profiles. v2.7.0 adds Omarchy's Text size slider under Brightness.
Also: Workspace numbers animate between displays when the plan changes; the compact view scrolls when taller than the screen.
Added: See which displays are on but show no picture, and…Improved: Drag monitors into place and set each one's mode, s…Added: Change the desktop text size from the panel, as in…
Try a saved profile with a 30-second preview without turning automatic selection off first.
Details
Redesigned editor with pages 1 Layout, 2 Workspaces, 3 Profiles (2 and 3 swapped), profile menus on right-click or Shift+F10 with confirmed deletion, off and mirrored displays as selectable cards. v2.4.1 adds Strategy Off to stop hyprmoncfg writing workspace rules. Requires hyprmoncfg 1.19.0. Groups v2.4.0-rc.1, v2.4.0 and v2.4.1.
v2.4.1; needs hyprmoncfg 1.19.0 or newer.
Improved: Apply the saved monitor profile that matches the co…Improved: Decide which Hyprland workspaces open on which moni…Behavior changedAction required
Reset single fields of a loaded profile back to their defaults.
Details
Per-field resets on the loaded profile; colour settings use display-standard colour-space and EOTF terms; previews survive monitor rebuilds. Requires hyprmoncfg 1.18.2. From v2.3.4 the panel no longer updates itself; updates come through Omarchy's plugin marketplace. v2.3.5 fixes previews on Omarchy 4.0.3.
v2.3.5; needs hyprmoncfg 1.18.2 or newer.
Improved: Drag monitors into place and set each one's mode, s…Action requiredAction requiredBehavior changedNow works: Drag monitors into place and set each one's mode, s…
Drive the panel with the same keys as the hyprmoncfg TUI.
Details
The expanded panel mirrors the TUI shortcuts (page keys, a applies, s saves, r resets, ? shows keys; arrows move a display). A fresh machine gets the prebuilt hyprmoncfg-bin package. Groups v2.1.0 to v2.1.4.
v2.1.4.
Improved: Drag monitors into place and set each one's mode, s…Improved: Install or update hyprmoncfg and restart its servic…
Arrange and configure your monitors in the bar panel itself, without opening the TUI.
Details
v2.0.0 turns the panel into a full display manager: a compact view with per-display brightness and a draggable layout, and an expanded editor for layout, saved profiles and workspace planning, with per-monitor mode, scale, rotation, position, enabled, VRR and mirroring, and preview, keep and revert. Requires hyprmoncfg 1.16.0.
v2.0.1; needs hyprmoncfg 1.16.0 or newer.
Added: Drag monitors into place and set each one's mode, s…Added: Change the brightness of each display from the pane…Added: Decide which Hyprland workspaces open on which moni…Improved: Apply the saved monitor profile that matches the co…Action required
See your monitor layout and active profile in the Omarchy bar, and have profiles switch on their own when you plug in displays or close the lid.
Details
First releases (v1.1.0 to v1.1.5): an Omarchy bar panel for hyprmoncfg with the live spatial layout, the active profile, automatic switching through the hyprmoncfgd user service, and an Install hyprmoncfg button that installs the AUR package in Omarchy's terminal. The panel offers Restart daemon when the running daemon is older than the installed one.
omarchy plugin add https://github.com/crmne/omarchy-hyprmoncfg.git --enable; needs Omarchy with third-party shell plugins and hyprmoncfg 1.12.0 or newer.
Added: Apply the saved monitor profile that matches the co…Added: See the live arrangement of your monitors and which…Added: Install or update hyprmoncfg and restart its servic…