How to Install Custom Cursors

Windows 11 & Windows 10

1. Unzip the downloaded pack to a permanent location like C:\Users\<you>\Cursors\PackName\.
2. Right-click install.inf and choose Install.
3. Open Settings → Bluetooth & devices → Mouse → Additional mouse settings → Pointers.
4. Pick the new scheme from the dropdown, click Apply, then OK.

Full walkthrough with troubleshooting: Windows install guide.

macOS (Sonoma and later)

1. Install Mousecape from its open-source GitHub project.
2. Grant Mousecape accessibility permission in System Settings.
3. In Mousecape, choose File → Import and pick the .cape file from the unzipped pack.
4. Right-click the imported cape and choose Apply.

macOS does not natively support custom system cursors; Mousecape is the standard third-party loader. Full walkthrough: macOS install guide.

Linux (X11 & Wayland)

1. Drop the theme folder into ~/.icons/ (current user) or /usr/share/icons/ (system-wide).
2. Switch the active cursor theme:
   • GNOME: GNOME Tweaks → Appearance → Cursor
   • KDE Plasma: System Settings → Colors & Themes → Cursors
   • Hyprland: set HYPRCURSOR_THEME and XCURSOR_THEME
   • Xfce: Settings → Mouse and Touchpad → Theme
3. Set XCURSOR_SIZE=48 (or 64) in your shell profile if cursors look small on HiDPI.

Full walkthrough: Linux install guide.

Browser-only (CSS)

For websites that want a custom cursor on their own visitors, no install required:

.btn { cursor: url('/cursors/hand.png') 8 4, pointer; }

Always include a fallback after the comma. Full walkthrough: CSS cursor guide.

Sizes & DPI