Arch Linux: Hyprland 0.46.2 Crashes After Upgrade — Here's a Temporary Workaround and a hyprutils-git Conflict Fix

Yesterday I encountered a nasty surprise after upgrading Hyprland to version 0.46.2—it crashed on startup, leaving me unable to log into my Wayland session. If you’re experiencing this problem, here’s a temporary workaround so you can keep working until a fix arrives.


The Issue

Hyprland 0.46.2 appears to crash immediately upon launch, preventing you from getting into your usual tiling window manager environment.


Update Dec 29 2024: hyprutils-git Caused Compatibility Issues

After some further digging, I discovered my Hyprland crash was caused by the AUR hyprutils-git package. I had previously switched to hyprutils-git from the AUR because I was also using hyprpolkitagent-git. Because of this, the entire Hyprland ecosystem ended up depending on the hyprutils-git package, which broke compatibility with the stable release of Hyprland in the last few updates.

[Read More]

Hyprland Quick-Start Guide Part 2: Enhancing Your Setup with Advanced Features

Update September 2026: I updated these examples after moving my CachyOS setup to Hyprland 0.56.2 and Lua. I switched to rofi, added swaync controls to Waybar, and started sorting out what happens to my workspaces when I unplug the dock. For the older compositor syntax, see the archived hyprlang docs.

In Part 1 we set up the desktop. Let’s put those configs under Stow first so we can keep them together while we change the theme and add the other helpers. The startup examples here go inside the same Lua hook.

[Read More]

Hyprland Quick-Start Guide: Setting Up a Modern Tiling Window Manager on Linux

Update September 2026: I revisited this setup on CachyOS with Hyprland 0.56.2. I moved the compositor config to Lua, switched the launcher to rofi, and got my wallpaper back with the new hyprpaper config. Some changes produced config errors. Others left a process running that did nothing, which took longer to figure out.

We’ll set up Hyprland with a terminal, file manager, launcher, bar, and lock screen. These examples target the setup I revisited. If you’re following the original guide on Hyprland 0.54 or older, use the archived hyprlang docs.

[Read More]