OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
omarchy-theming low common DISPUTE

Set a cursor theme that Hyprland, GTK, Qt and XWayland apps all agree on

archhyprlandomarchyomarchy-4wayland
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The cause is fully verified: default/hypr/envs.lua exports only hl.env("XCURSOR_SIZE", "24") and hl.env("HYPRCURSOR_SIZE", "24") with no XCURSOR_THEME and no hyprctl setcursor, nothing in post_theme_commands touches XCursor, and omarchy-theme-color derives cursor from bright_foreground (terminal cursor, not pointer). The hyprctl wiki says setcursor "Will set the theme for everything except GTK" and "since 0.37.0, this only accepts hyprcursor themes. For legacy xcursor themes, use the XCURSOR_THEME and XCURSOR_SIZE env vars". The option cursor:sync_gsettings_theme defaults to true, install/user/hardware/fix-nouveau-cursor.sh appends the identical no_hardware_cursors block to ~/.config/hypr/looknfeel.lua, and hypr.monitors really is required before hypr.autostart in config/hypr/hyprland.lua, next to the GDK_SCALE line. Two concrete errors in the fix: (a) xcursor-breeze is not an Arch package: the xcursor-* packages in Extra are xcursor-comix, xcursor-themes, xcursor-vanilla-dmz(-aa) only. Breeze cursors come from breeze-cursors, and that package installs breeze_cursors and Breeze_Light, not Breeze_Snow (the breeze package ships no cursors at all). (b) sudo pacman -Syu <pkg> is aborted on Omarchy 4 by default/libalpm/hooks/00-omarchy-update-guard.hook -> omarchy-update-pacman-guard, which refuses any transaction carrying both S and u with "Woah partner...".

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

Symptom

The mouse pointer stays the default white arrow no matter which Omarchy theme you set. It never changes with the theme. Inside XWayland clients (Steam and Proton games, JetBrains IDEs, older Electron apps) it is a different pointer again: the black X11 "X", or a giant pointer, or nothing at all. hyprctl setcursor <theme> 24 reports success but only some apps change.

Cause

Omarchy themes carry no cursor. There is no cursor key in colors.toml (the cursor key that omarchy-theme-color resolves is the *terminal text* cursor, derived from bright_foreground), and nothing in post_theme_commands touches XCursor. Omarchy exports only a size, in /usr/share/omarchy/default/hypr/envs.lua: hl.env("XCURSOR_SIZE", "24") and hl.env("HYPRCURSOR_SIZE", "24"), with no XCURSOR_THEME and no hyprctl setcursor. So the pointer is whatever the default cursor theme resolves to. Three mechanisms then disagree. Since Hyprland 0.37 hyprctl setcursor accepts **hyprcursor** themes only and legacy xcursor themes must come from XCURSOR_THEME/XCURSOR_SIZE. GTK reads its own gtk-cursor-theme-name setting (which is why the wiki says setcursor "will set the theme for everything except GTK"). XWayland clients read the X root resource the compositor publishes from those env vars, which hl.env only reaches if it is set before the client starts.

Fix

Replace the install step and the theme name:


ls -d /usr/share/icons/*/cursors 2>/dev/null
omarchy update                     # syncs+upgrades; a direct `pacman -Syu` is refused by Omarchy's ALPM guard
sudo pacman -S breeze-cursors      # installs /usr/share/icons/breeze_cursors and /usr/share/icons/Breeze_Light

Then use the real theme name everywhere (breeze_cursors, or Breeze_Light):


cat >> ~/.config/hypr/monitors.lua <<'EOF'

-- Cursor theme. hl.env only reaches processes Hyprland starts after this line.
hl.env("XCURSOR_THEME", "breeze_cursors")
hl.env("XCURSOR_SIZE", "24")
EOF

Only set HYPRCURSOR_THEME/HYPRCURSOR_SIZE if you actually installed a hyprcursor theme (e.g. from the AUR). Pointing it at an xcursor-only name just falls back. Then:


gsettings set org.gnome.desktop.interface cursor-theme 'breeze_cursors'
gsettings set org.gnome.desktop.interface cursor-size 24
mkdir -p ~/.local/share/icons/default
printf '[Icon Theme]\nInherits=breeze_cursors\n' > ~/.local/share/icons/default/index.theme

Log out and back in. The rest of the record (no_hardware_cursors block, log-out requirement for XWayland) is correct as written.

Verify

hyprctl getoption cursor:no_hardware_cursors reports what you set, and tr '\0' '\n' < /proc/$(pgrep -x Hyprland)/environ | grep XCURSOR shows your theme. Open a native app, a GTK app and an XWayland app (steam or xterm) side by side. All three draw the same pointer at the same size.

Sources

cursor-theme-not-following-theme-or-xwayland