Fix cursor artifacts, ghosting or an invisible cursor on NVIDIA + Hyprland
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.
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.