Custom Cursor Style Injector

WHAT IT DOES

Custom Cursor Style Injector lets you replace the default mouse cursor with a style that reflects your personality or improves visibility. A panel overlay provides a selection of pre-defined cursor styles including crosshair, pointer, grab, grabbing, zoom-in, zoom-out, progress, wait, text, move, not-allowed, help, and resize variants. You can also upload custom cursor images in PNG or SVG format (via URL or data URI), or create a simple colored dot cursor with adjustable size and color. Changes apply in real-time as you adjust settings, and preferences are saved per-site so you can have different cursors for different websites. A small preview in the bottom-right corner shows your current cursor style, and you can toggle the preview on or off. Perfect for accessibility needs, personalization, or adding a playful touch to your browsing experience.

WHERE IT RUNS

This script runs on any webpage, applying CSS to override the default cursor across all elements. It operates entirely within your browser tab, injecting a style element into the page's head. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including cursor type, custom image, cursor size, cursor color, per-site override, and auto-apply preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically applies your default cursor settings to every page you visit (if auto-apply is enabled). Use the dropdown menu to select from over 20 pre-defined cursor styles. Upload a custom cursor image by entering a URL or data URI—the script supports PNG and SVG images. For a simple custom cursor, select "Custom (colored dot)" and adjust the color and size using the color picker and size slider. The cursor updates instantly as you make changes. The preview shows your current cursor style in the bottom-right corner—click "Hide Preview" to toggle it. Enable "Per-site Override" to save different cursor settings for different domains. Click "Reset to Defaults" to restore the original cursor.

THE REAL MECHANISM

The script injects a CSS style element with a universal selector (*) and the cursor property set to the desired value. For pre-defined presets, it uses the standard CSS cursor keywords (crosshair, pointer, grab, zoom-in, etc.). For custom images, it constructs a CSS url() value pointing to the image URL or data URI, with a fallback to 'auto'. For the colored dot cursor, the script generates an inline SVG data URI containing a circle filled with the user's chosen color and a small highlight, then embeds it as a cursor image. The cursor size is controlled by the SVG dimensions and the hotspot coordinates (set to the center of the image). All changes are applied in real-time by updating the style element's text content. The per-site override system stores a complete settings object per domain using GM_setValue, allowing independent configurations. The preview element is positioned absolutely and follows the cursor style visually. All CSS injection uses safe methods with no innerHTML from untrusted content.

THE PANEL

The Custom Cursor panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the controls. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Custom cursor images may be blocked by some websites' Content Security Policies (CSP) if they restrict external resources. The colored dot cursor is generated as a data URI and should work on most sites. The script uses the !important flag to override page styles, which may cause conflicts with other cursor-related rules. Some browsers may not support all cursor keywords or custom cursor images—fallback to 'auto' is provided. Large custom images may affect performance. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your cursor type, custom image URL, cursor size, cursor color, per-site override preference, and auto-apply preference locally. No page content, cursor data, or personal information is ever collected, transmitted, or shared.