Installing X11 and Wayland Cursor Themes on Linux

Linux has the cleanest custom-cursor story of any major desktop OS, because cursor themes are a first-class part of the X11 cursor system (and Wayland inherits the same theme format). Drop a folder, switch a setting, done.

Step 1 — Place the theme folder

Each CursorCraft Linux download ships an XCursor-format theme: a folder containing an index.theme file and a cursors/ subdirectory with the rendered pointer images. Place the theme folder in either:

~/.icons/ — for the current user only (no sudo required)
/usr/share/icons/ — for every user on the system (requires sudo)

Step 2 — Activate

Switch the active cursor theme from your desktop environment’s appearance settings:

GNOME 45+: install GNOME Tweaks, open Appearance → Cursor, pick the theme.
KDE Plasma 6: System Settings → Colors & Themes → Cursors.
Hyprland / wlroots: set HYPRCURSOR_THEME and XCURSOR_THEME in your config; reload.
Xfce: Settings → Mouse and Touchpad → Theme.

Step 3 — Verify on Wayland

Wayland uses the same XCursor format but is stricter about HiDPI. If your cursor looks tiny on a 4K monitor, set XCURSOR_SIZE=48 in your shell profile (or 64 on a really dense panel). Log out and back in for the change to apply.

Animations

XCursor supports animated cursors via multi-frame PNGs. CursorCraft Linux packs ship animated variants for watch, progress, and the busy spinners; pointer and link cursors are static by convention because Linux desktop conventions discourage motion on idle cursors.

Removing

Delete the theme folder from ~/.icons (or /usr/share/icons) and switch back to your previous theme in the appearance settings. There is no registry to clean.