OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
display-monitors medium very-common DISPUTE

Fix 'keyword can't work with non-legacy parsers' from monitor scripts

omarchyarchendeavouroscachyoshyprlandwayland
AUDITED Audited against its sources and confirmed accurate.

Symptom

Any script or command that used to work now fails: hyprctl keyword monitor "HDMI-A-1,2560x1440@59.95,1600x0,1" returns keyword can't work with non-legacy parsers. Use eval. The Omarchy display panel's enable/disable switch also appears to do nothing. You flip it and the monitor stays exactly as it was.

Cause

Hyprland 0.55 replaced hyprlang with a Lua config parser (Omarchy 4 "Quattro" ships Hyprland 0.56.x with Lua configs). hyprctl keyword only speaks the legacy hyprlang parser, so it refuses every monitor command outright. Scripts, dotfiles and blog posts written for Hyprland <= 0.54 silently stop working, and Omarchy's own display widget shipped the old call for a while (fixed in PR #7036).

Fix

Send monitor changes through hyprctl eval with a Lua hl.monitor call instead of hyprctl keyword.


# WRONG on Hyprland 0.55+ / Omarchy 4
hyprctl keyword monitor "HDMI-A-1,2560x1440@59.95,1600x0,1"

# RIGHT
hyprctl eval 'hl.monitor({ output = "HDMI-A-1", mode = "2560x1440@59.95", position = "1600x0", scale = 1 })'

# disable / re-enable an output at runtime
hyprctl eval 'hl.monitor({ output = "HDMI-A-1", disabled = true })'
hyprctl eval 'hl.monitor({ output = "HDMI-A-1", disabled = false })'

To make it permanent, put the same call in ~/.config/hypr/monitors.lua:


hl.monitor({ output = "HDMI-A-1", mode = "2560x1440@59.95", position = "1600x0", scale = 1 })

On Hyprland <= 0.54 / Omarchy 3.x the file is ~/.config/hypr/monitors.conf and the syntax is monitor=HDMI-A-1,2560x1440@59.95,1600x0,1.

Verify

hyprctl eval '...' prints ok and hyprctl monitors immediately shows the new mode/position/scale.

Sources

hyprctl-keyword-monitor-non-legacy-parser