OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
hyprland-config medium common DISPUTE

Clear the config errors Hyprland 0.55 throws for options it removed

hyprlandomarchyarchendeavouroscachyosmanjaro
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Nearly all verified. hypr.land/news/update55 lists exactly these breaking changes: dwindle:pseudotile removed ('as it wasn't doing anything'), decoration:shadow:ignore_window removed, render:cm_fs_passthrough removed, misc:vfr moved to debug:, and the current Variables wiki indeed shows vfr under the Debug subcategory. Omarchy issue #5758 is real, quotes these exact three errors, and PR #5723 ('Hyprland lua conversion') is merged. windowrule = match:class ^(mpv)$, pseudo on and the Lua equivalent are both valid (pseudo is a documented static effect). One factual error in the fix: the claim that deleting col.border_locked_* makes Hyprland 'fall back to col.border_active/col.border_inactive' is false. The current Variables wiki gives group.col.border_locked_active its own default of 0x66ff5500 and col.border_locked_inactive 0x66775500. Deleting the lines yields those orange group colors, not your normal border colors. Separately, the suggested replacement rgba(00000000) makes locked-group borders fully transparent, which removes the visual cue that a group is locked. That is a deliberate choice, not a neutral one, and should be stated.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

Editing /usr/share/omarchy/ or ~/.local/share/omarchy/default/ directly is reverted by the next update.

Symptom

Three errors on a fresh boot after updating to Hyprland 0.55: Config error in file /home/<user>/.local/share/omarchy/default/hypr/looknfeel.conf at line 53: Error parsing gradient -1: failed to parse -1 as a color, the same for line 54, and Config error in file .../looknfeel.conf at line 111: config option dwindle:pseudotile does not exist.

Cause

Hyprland 0.55 removed dwindle:pseudotile (it had become a no-op, and pseudotiling is per-window only now) and stopped accepting the -1 'inherit from parent colour' shorthand for group:col.border_locked_active / col.border_locked_inactive. The parser now demands a real colour or gradient. 0.55 also removed decoration:shadow:ignore_window and render:cm_fs_passthrough, and moved misc:vfr to debug:vfr.

Fix

Removals and the misc:vfr -> debug:vfr move are correct as written. Fix the border_locked guidance:

Deleting col.border_locked_active / col.border_locked_inactive does NOT fall back to col.border_active/col.border_inactive. Those keys have their own defaults (0x66ff5500 active, 0x66775500 inactive), so you get orange locked-group borders.

Pick deliberately:


group {
  # Keep locked groups visually distinct (just delete the -1 lines, accept defaults):
  #   -> orange 0x66ff5500 / 0x66775500

  # Or reproduce the old "inherit" look by naming your normal border colors:
  col.border_locked_active   = rgba(33ccffee) rgba(00ff99ee) 45deg
  col.border_locked_inactive = rgba(595959aa)

  # rgba(00000000) is NOT "inherit" - it makes locked-group borders invisible.
}

dwindle { }              # pseudotile removed in 0.55
misc    { }              # vfr moved out of misc
debug   { vfr = true }   # default is already true; only set if you changed it

On 0.55+ hyprctl getoption documents the dot form, so prefer hyprctl getoption dwindle.pseudotile and hyprctl getoption group.col.border_locked_active (the colon form still resolves). And the record is right that these lines live in the package-owned defaults: run omarchy-update, do not edit them.

Verify

hyprctl configerrors is empty and hyprctl getoption debug:vfr returns a value.

Sources

hyprland-055-removed-options-pseudotile-border-locked