How nexind/cursorswarm works
CursorSwarm is a local Windows desktop app for customizing the visible cursor and rendering animated cursor effects. The user configures effects in the control panel or Cursor Lab; the app combines those settings with mouse position in its animation loop and draws overlays. Separate workflows cover themes and presets, startup and performance settings, and cursor restoration and stability checks. These capabilities are documented in the README, but v13.12 is a single-file program and the excerpts are partial, so internal links are limited to behavior supported by the excerpts or documentation.
Main entry points: cursor_swarm_v13_12.py Animation loop
Components 19
User interface
- Control panel
src/cursor_swarm_v13_12.py - Cursor Lab
src/cursor_swarm_v13_12.py
Cursor effects
- Cursor overlays
src/cursor_swarm_v13_12.py - Fake cursor swarm
src/cursor_swarm_v13_12.py - Movement effects
src/cursor_swarm_v13_12.py - Click effects
src/cursor_swarm_v13_12.py - Idle effects
src/cursor_swarm_v13_12.py - Cursor shapes
src/cursor_swarm_v13_12.py
Customization state
- Themes
src/cursor_swarm_v13_12.py - Presets
src/cursor_swarm_v13_12.py - App settings
src/cursor_swarm_v13_12.py - Local app data
src/cursor_swarm_v13_12.py
Runtime and safety
- Animation loop
src/cursor_swarm_v13_12.py - Performance controls
src/cursor_swarm_v13_12.py - Stability check
src/cursor_swarm_v13_12.py - Safe cursor restore
src/cursor_swarm_v13_12.py
Other components
- User
- Windows desktop
- Mouse position
Connections 24
- User → Control panel: configures
- User → Cursor Lab: customizes
- Control panel → Themes: manages
- Control panel → Presets: manages
- Control panel → App settings: sets
- Control panel → Performance controls: configures
- Control panel → Stability check: runs
- Cursor Lab → Cursor shapes: customizes
- Cursor Lab → Cursor overlays: configures
- Themes → Local app data: reads/writes
- Presets → Local app data: reads/writes
- App settings → Local app data: reads/writes
- Animation loop → Mouse position: reads position
- Animation loop → Fake cursor swarm: updates
- Animation loop → Movement effects: renders
- Animation loop → Click effects: renders
- Animation loop → Idle effects: renders
- Animation loop → Cursor overlays: draws
- Animation loop → Performance controls: uses limits
- Windows desktop → Mouse position: provides position
- Cursor overlays → Windows desktop: draws on
- Cursor shapes → Windows desktop: uses cursor assets
- Safe cursor restore → Windows desktop: restores cursor
- Stability check → Local app data: checks storage