OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
gpu-drivers low very-common DISPUTE

Fix cursor artifacts, ghosting or an invisible cursor on NVIDIA + Hyprland

omarchyarchendeavouroscachyosmanjarohyprlandwaylandnvidiadesktoplaptop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The main fix is right and current: I confirmed against Hyprland's Variables.md that cursor:no_hardware_cursors is an int defaulting to 2 ('0 - use hw cursors if possible, 1 - don't use hw cursors, 2 - auto (disable when tearing)'), and that no_break_fs_vrr's description literally says 'may require no_hardware_cursors = true'. The tail is wrong: hyprcursor is the cursor format/library/utilities package. Installing it gives you no cursor theme at all, so hyprctl setcursor <ThemeName> 24 will fail with whatever name the user guesses. You need an actual theme package.

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

Symptom

The mouse pointer leaves trails, flickers, disappears entirely over some windows, or a frozen 'ghost' cursor stays on screen after a game exits, on an NVIDIA GPU under Hyprland.

Cause

Hyprland uses a hardware cursor plane by default (cursor:no_hardware_cursors = 2, auto). NVIDIA's hardware cursor plane misbehaves in several situations: mixed-scale multi-monitor setups, tearing/direct-scanout, and after an XWayland client dies holding a cursor surface.

Fix

Force software cursors. Hyprland <= 0.54, in ~/.config/hypr/hyprland.conf:


cursor {
    no_hardware_cursors = 1
}

Hyprland 0.55+ / Omarchy 4 Lua config:


hl.set("cursor:no_hardware_cursors", 1)

Apply without restarting:


hyprctl reload

If instead of artifacts you see the default Hyprland logo cursor, you have no cursor **theme** installed. hyprcursor is only the library/format, not a theme. Install a real theme and select it by its directory name:


sudo pacman -S --needed adwaita-cursors      # or xcursor-themes, breeze, a bibata-* AUR theme...
ls /usr/share/icons                          # theme names live here
hyprctl setcursor Adwaita 24

Make it stick across sessions by also exporting the theme for XWayland/GTK clients:


env = XCURSOR_THEME,Adwaita
env = XCURSOR_SIZE,24

hl.env("XCURSOR_THEME", "Adwaita")
hl.env("XCURSOR_SIZE", "24")

Note cursor:no_break_fs_vrr = 1 requires no_hardware_cursors = 1 to take effect.

Verify

hyprctl getoption cursor:no_hardware_cursors returns 1, and moving the pointer across monitors leaves no trails or ghosts.

Sources

hyprland-nvidia-cursor-artifacts-hardware-cursors