If you're running Omarchy with Hyprland, you might encounter a configuration error like this when starting or reloading Hyprland:
Config error in the file .config/omarchy/current/theme/hyprland.conf at line 34:
windowrulev2 is deprecated
This error appears because recent versions of Hyprland removed the windowrulev2 directive.
Why This Happens
In newer releases of Hyprland, the window rule system was simplified. The windowrulev2 directive was removed, and its functionality was merged into the standard windowrule directive.
As a result, any older configuration files, especially themes bundled with distributions like Omarchy may still reference windowrulev2, which now triggers a configuration error.
The Fix
The fix is quick and easy. You'll need to replace windowrulev2 with windowrule.
And thats it...
Original configuration
# Change border color on full screen
windowrulev2 = bordercolor $love, fullscreen:1
Updated configuration
# Change border color on full screen
windowrule = bordercolor $love, fullscreen:1
Reload Hyprland
If it hasn't already updated after saving, just reload the configuration:
hyprctl reload
Hyprland will reload the config and the error should disappear.
More context on the Omarchy theme
In many Omarchy themes, this rule appears near the end of the theme configuration file:
~/.config/omarchy/current/theme/hyprland.conf
The rule typically changes the window border color when a window enters fullscreen mode.
Configuration changes like this are common in Wayland projects. If you update Hyprland and suddenly start seeing configuration errors, it's often due to deprecated directives in older configs or themes.
Replacing windowrulev2 with windowrule should resolve the issue immediately and keep your setup compatible with modern Hyprland versions.
If you're maintaining a theme or dotfiles repository, it’s a good idea to update your configs so others don’t encounter the same issue.