I ran sudo pacman -Syu to bring Omarchy up to date. After rebooting, Hyprland refused to start: after logging in I saw a Dell logo and then was stuck on a black screen. How did I fix it?

Why it breaks

Hyprland updates frequently, and plugins must sometimes be rebuilt manually. When the plugin doesn’t match the Hyprland version, the compositor fails during startup, so you never reach the desktop. In my case, the split-monitor-workspaces plugin turned out to be the culprit.

Get back into the system

1. Switch to a TTY with Ctrl+Alt+F3 (or any free console) and log in.
2. Temporarily disable the plugin so Hyprland can start:

   mv ~/.config/hypr/plugin-split-monitor-workspace.conf{,.disabled}

3. Restart the display manager or reboot. Without the plugin config file, Hyprland loads and you can work from the desktop again. The layout and configuration of the workspaces might not be as you expect, but you have a working system at least.

Rebuild the plugin

Open a terminal (or stay on the TTY) and rebuild the plugin against the new Hyprland version:

hyprpm update
hyprpm enable split-monitor-workspaces

If hyprpm complains that the plugin is missing, add it again with:

hyprpm add https://github.com/Duckonaut/split-monitor-workspaces

Restore the config

Move the configuration back in place and reload Hyprland:

mv ~/.config/hypr/plugin-split-monitor-workspace.conf{.disabled,}
hyprctl reload

This is often enough to restore your usual configuration. If not, a reboot will help.