Customizable Cursor

An Obsidian plugin that adds a beautiful animated cursor trail effect to your editor. Fully customizable with 31 built-in presets, custom theme support, and a live preview.

Features

• 31 Built-in Presets — From subtle to dramatic: Default, Neon, Fire, Matrix, Cyberpunk, Aurora, and many more
• Full Customization — Control every aspect of your cursor animation:
  • Cursor color, width, and opacity
  • Trail color, opacity, and toggle
  • Glow color, intensity, and toggle
  • Animation duration and easing curves
  • Trigger events (keyboard, mouse, touch)
• Custom Presets — Save your own themes and switch between them instantly
• Favorites — Star your favorite presets for quick access
• Live Preview — Test your cursor settings in the settings panel with click, drag, or auto-demo
• Custom CSS — Inject your own CSS for advanced customization

Screenshots

Coming soon

Installation

From Obsidian Community Plugins

1. Open Obsidian Settings
2. Go to Community Plugins and disable Safe Mode
3. Click Browse and search for "Customizable Cursor"
4. Install and enable the plugin

Manual Installation

1. Download main.js and manifest.json from the latest release
2. Create a folder named customizable-cursor in your vault's .obsidian/plugins/ directory
3. Place the downloaded files in this folder
4. Reload Obsidian and enable the plugin in Settings → Community Plugins

Usage

1. Open Settings → Customizable Cursor
2. Browse the visual preset grid and click to apply
3. Customize individual settings to your liking
4. Use the Preview area to test your changes
5. Save your configuration as a custom preset

Presets

Category	Presets
Classic	Default, Minimal, Ghost, Zen
Vibrant	Neon, Cyberpunk, Rave, Electric, Candy
Nature	Fire, Lava, Ocean, Forest, Aurora, Ice
Dark	Matrix, Hacker, Midnight, Vampire, Blood Moon, Stealth
Warm	Sunset, Gold, Retro
Cool	Galaxy, Synthwave, Lightning
Fun	Bubblegum, Cotton Candy, Radioactive, Laser

Settings

Cursor Settings

Setting	Description	Range
Color	The color of the cursor bar	Any hex color
Width	Cursor width in pixels	1-20
Opacity	Cursor transparency	0-100%

Trail Settings

Setting	Description	Range
Enable Trail	Toggle the animated trail effect	On/Off
Trail Color	Color of the trail behind the cursor	Any hex color
Trail Opacity	Trail transparency	0-100%

Glow Settings

Setting	Description	Range
Enable Glow	Toggle the glow effect around the cursor	On/Off
Glow Color	Color of the glow effect	Any hex color
Glow Intensity	Blur radius of the glow	0-30

Animation Settings

Setting	Description	Range
Duration	Animation duration in milliseconds	20-300ms
Easing	Animation easing curve	Various options
Fade	Enable fade effect during animation	On/Off
Rotation	Enable trail rotation effect	On/Off

Trigger Settings

Setting	Description	Default
Keyboard	Animate on keyboard input	On
Mouse	Animate on mouse clicks	On
Touch	Animate on touch events	On

Behavior Settings

Setting	Description	Default
Reset on Pane Change	Reset cursor position when switching panes	On

Advanced Settings

Setting	Description
Custom CSS	Inject custom CSS for advanced styling

Requirements

• Obsidian v1.0.0 or higher
• Works on desktop and mobile

Mobile Compatibility

This plugin supports both desktop and mobile platforms. However, there are some differences in behavior:

Touch Support

• Touch triggers are enabled by default in settings
• Tap and touch events work in the editing view (Live Preview mode)
• The animated cursor follows your touch position as you edit

Known Limitations

• Editor-only: Cursor animation only works in editing mode (Live Preview), not in Reading mode
• Touch precision: Touch coordinates may vary slightly between devices
• Performance: Older mobile devices may experience reduced animation smoothness with intensive glow effects

Recommended Mobile Settings

For the best mobile experience:

• Consider using lighter presets (Default, Minimal, Zen) for better performance
• Lower glow intensity if animations feel sluggish
• Adjust animation duration to find the right balance for your device

Changelog

See Releases for version history.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests on GitHub.

License

MIT License - see LICENSE for details.

Support

If you encounter any issues or have feature requests, please open an issue on GitHub.