Mouse cursor is invisible, enormous, or the wrong theme in XWayland apps
The nouveau claim is exact, not approximate: install/user/hardware/fix-nouveau-cursor.sh in quattro appends to $HOME/.config/hypr/looknfeel.lua the block hl.config({ cursor = { no_hardware_cursors = true } }) with a comment stating nouveau does not display the hardware cursor plane on many older NVIDIA GPUs, so the boolean form is what upstream Omarchy itself writes for that int option, and the record's snippet is byte-comparable. hyprcursor wiki confirms the following. Themes go in ~/.local/share/icons or ~/.icons and it is "not recommended" to use system-wide /usr/share/icons. GTK does not do server-side cursors so it needs gsettings set org.gnome.desktop.interface cursor-theme, with the dconf write fallback when schemas are missing, and flatpak override --filesystem=~/.themes:ro --filesystem=~/.icons:ro --user for flatpaks. Hyprland falls back to XCursor/env vars when no hyprcursor theme exists. Using-hyprctl confirms hyprctl setcursor takes hyprcursor themes only since 0.37 and "will set the theme for everything except GTK, because GTK." envs.lua really ships XCURSOR_SIZE=24 and HYPRCURSOR_SIZE=24, and config/hypr/hyprland.lua loads require("hypr.looknfeel") after require("default.hypr.omarchy"), so the stated override point is correct. Only a soft caveat: cursor.sync_gsettings_theme defaults to true and does push the xcursor theme/size into gsettings on theme load, so "GTK ignores all four" is slightly stronger than reality, but the gsettings step is still the reliable fix and is what the wiki prescribes.
Symptom
Any of the following. The pointer vanishes entirely (often on older NVIDIA cards running nouveau, or only over certain surfaces). The pointer is gigantic in GIMP, Steam or pavucontrol while normal everywhere else. The pointer is the default black X11 cross in XWayland apps but your chosen theme in Wayland apps. Or the pointer is literally the Hyprland logo.
Cause
Three unrelated mechanisms all showing up as "the cursor is wrong". (1) **Hardware cursor plane.** The compositor hands the pointer to a DRM cursor plane, and nouveau does not display it on many older NVIDIA GPUs, so the pointer is composited nowhere and you see nothing. (2) **Two cursor systems.** Hyprland prefers hyprcursor (HYPRCURSOR_THEME/HYPRCURSOR_SIZE). Apps that do not support server-side cursors, GTK in particular, fall back to XCursor and read XCURSOR_THEME/XCURSOR_SIZE plus the GTK gsettings key. Set one and not the other and you get a split. If neither resolves to an installed theme, Hyprland draws its own logo. (3) **Size on scaled outputs.** XCURSOR_SIZE is a fixed pixel number. With xwayland:force_zero_scaling on, the XWayland side is unscaled, so a size chosen for a 2x display looks enormous in X11 apps.
Fix
**Invisible pointer: disable the hardware cursor plane.** Add to ~/.config/hypr/looknfeel.lua (Omarchy) or hyprland.lua:
hl.config({
cursor = {
no_hardware_cursors = true,
},
})
This is precisely what Omarchy's installer appends to ~/.config/hypr/looknfeel.lua when it detects Kernel driver in use: nouveau. Confirm you are on nouveau with lspci -k | grep -A3 -i vga. On the proprietary NVIDIA driver, try cursor { use_cpu_buffer = 1 } first. That is the supported way to keep HW cursors working there.
**Wrong or split theme: set both systems and GTK.** Install a theme (hyprcursor themes go in ~/.local/share/icons or ~/.icons, *not* /usr/share/icons), then:
hl.env("HYPRCURSOR_THEME", "Bibata-Modern-Classic")
hl.env("HYPRCURSOR_SIZE", "24")
hl.env("XCURSOR_THEME", "Bibata-Modern-Classic")
hl.env("XCURSOR_SIZE", "24")
GTK ignores all four. It needs gsettings:
gsettings set org.gnome.desktop.interface cursor-theme 'Bibata-Modern-Classic'
gsettings set org.gnome.desktop.interface cursor-size 24
# if gsettings schemas are unavailable:
# dconf write /org/gnome/desktop/interface/cursor-theme "'Bibata-Modern-Classic'"
Apply live without a relogin (note: since 0.37 setcursor takes **hyprcursor** themes only, and legacy XCursor themes must go through the env vars):
hyprctl setcursor Bibata-Modern-Classic 24
**Flatpak apps with the wrong cursor:**
flatpak override --user --filesystem=~/.themes:ro --filesystem=~/.icons:ro
Omarchy 4 ships XCURSOR_SIZE=24 and HYPRCURSOR_SIZE=24 in /usr/share/omarchy/default/hypr/envs.lua. Override them in ~/.config/hypr/looknfeel.lua, which is loaded after the defaults.
Env vars only reach apps launched afterwards, so run hyprctl reload and then restart the app.
Verify
hyprctl getoption cursor:no_hardware_cursors reflects your setting. The pointer is visible and correctly sized over a fullscreen XWayland app (GIMP or Steam) and over a native Wayland one (nautilus/foot) at the same time.
Sources
- https://wiki.hypr.land/Hypr-Ecosystem/hyprcursor/
- https://wiki.hypr.land/FAQ/
- https://wiki.hypr.land/Configuring/Basics/Variables/
- https://wiki.hypr.land/Configuring/Advanced-and-Cool/Using-hyprctl/
- https://github.com/hyprwm/Hyprland/issues/7349
- https://github.com/basecamp/omarchy/blob/quattro/install/user/hardware/fix-nouveau-cursor.sh
- https://github.com/basecamp/omarchy/blob/quattro/default/hypr/envs.lua
- https://wiki.archlinux.org/title/Hyprland