Extension setup
- 1. Open the extension page in your browser (Chrome Web Store or Edge Add-ons).
- 2. Click
Add to Chrome
/Get
and confirm the installation. - 3. Optionally pin the icon: click the
Puzzle
icon →Pin
. - 4. Permissions: on first launch grant the required permissions (cursor/page styles).
Or manual install (for developers)
- 1. Download catcursor-extension.zip and unzip it.
- 2. Open
chrome://extensions
oredge://extensions
. - 3. Enable
Developer mode
. - 4. Click
Load unpacked
and select the extension folder.
Get new cursor themes, examples and extension updates.
All features — free
No tiers, no paywalls, no trials. Install and enjoy.
Open-source. Great for hobby, websites and production.
- All effects, including sounds
- One-minute easy integration
- Custom cursors and pointer with hotspot
- A/B parameters for experiments
- API/SDK for extensions
- Community support
We’ve got answers
What is CatCursor?
A lightweight way to customize the mouse cursor and its trail: from a cute cat paw 🐾 to any custom icons, animations, and images. Adds a wow-effect without heavy deps.
How do I install it?
Available as a browser extension (Chrome/Edge) or as a library for your site. The extension lets you manage themes and effects; the library gives you full control in code.
How much does it cost?
It’s all free. No tiers, no paywall, no trials. Use it for hobby or production.
Does it affect SEO?
No. CatCursor runs client-side after render and doesn’t modify page content, meta tags, or HTML structure.
What about performance?
Tiny core (<8kb gzip), events are rAF-throttled, effects are optimized. Smooth by default, even on mobile.
Mobile support?
Yes. Effects adapt to touch, power saving and mobile browser constraints.
Which browsers are supported?
Current Chrome, Edge, Firefox and Safari. Some browsers may limit cursor image size or treat SVG differently.
Which image formats & sizes should I use?
PNG/SVG/WebP with transparency are fine. Recommended size up to 128×128 px for the cursor (up to 256×256 px for retina). Large images may be auto-downscaled.
For cursor trails (particles), 16–72 px usually looks best.
What is a hotspot and how to set it?
The hotspot is the click point inside your cursor (e.g., paw tip). Move it on the preview crosshair; it applies instantly.
What’s the difference between “cursor” and “pointer”?
Cursor is the base mouse arrow. Pointer is the style over interactive elements (links, buttons). CatCursor lets you configure both.
Are there any sounds?
Optional: “meow”, “tap”, “ding”. Enabled on user gesture (browser audio policies). Volume/frequency are configurable.
What are the characters chasing the cursor?
Optional animated buddies that follow the cursor and interact with the page. Starts with a few cats 😺, more styles later.
They’ll respect intensity limits (so they don’t harm UX) and only run where you enable them.
Accessibility (a11y)?
We honor prefers-reduced-motion
, keep focus styles intact, and let users disable effects. Goal: decorative, never disruptive.
Privacy & security?
No data to third-party servers. Everything runs locally in the browser. The extension requests only the permissions needed to display the cursor.
Works with React/Next/Vue/Vanilla/WordPress?
Yes. Examples for Next.js/React and a vanilla script for any site. SSR-safe: effects attach after hydration.
How to disable on specific pages?
In the extension, toggle it off for the domain/page. In the library, control flags in your code (e.g., disable trail or cursor conditionally).