Skip to content

A funky Windows application that adds special effects to the mouse pointer, using the GPU for faster rendering.

License

Notifications You must be signed in to change notification settings

ltrudu/MouseEffects

Repository files navigation

MouseEffects

A GPU-accelerated visual effects overlay for Windows that creates stunning cursor effects in real-time.

Windows .NET 8 DirectX 11 License

Overview

MouseEffects is a modular, plugin-based application that renders beautiful visual effects following your mouse cursor. Built with DirectX 11 for maximum performance, it runs as a transparent overlay on top of all your windows.

Key Features

  • GPU-Accelerated Rendering - Smooth 60+ FPS effects using DirectX 11
  • Plugin Architecture - Easily extensible with custom effects
  • Screen Capture Integration - Effects can interact with screen content
  • Multi-GPU Support - Works with hybrid graphics (Intel + NVIDIA/AMD)
  • Low Resource Usage - Optimized rendering pipeline
  • System Tray Integration - Runs quietly in the background
  • Auto-Updates - Automatic updates via GitHub Releases (Velopack)
  • Modern UI Theming - Light, Dark, or System theme with ModernWPF

Built-in Effects

Effect Description
Particle Trail Colorful particles that follow your cursor with physics simulation
Laser Work Directional lasers shooting from cursor with collision detection
Screen Distortion Real-time lens/ripple distortion effect
Color Blindness CVD simulation & correction with 17 filter types (Machado/Strict algorithms), zone layouts, and comparison view
Color Blindness NG Next-gen CVD plugin with per-zone configuration, 4 correction algorithms (LUT, Daltonization, Hue Rotation, CIELAB), custom presets, interactive visual controls (gradient editor, color spectrum preview, blend mode swatches, CIELAB axis control), Circle/Rectangle cursor-following modes, Simulation-Guided Correction, and Re-simulation mode
Radial Dithering Bayer-pattern dithering effect around cursor
Tile Vibration Vibrating tiles that capture and display screen content
Water Ripple Expanding water ripples on click with realistic wave interference
Zoom Magnifying lens effect with circle or rectangle shape and hotkey support
Firework Stunning firework explosions with rockets, trails, and secondary explosions
Space Invaders Defend against neon invaders with rockets - includes scoring and leaderboard
ASCIIZer Renders screen as ASCII art with 6 filter modes: ASCII Art Classic (luminance-to-character mapping), Matrix Rain (falling green characters), Dot Matrix (LED display simulation), Typewriter (mechanical typewriter with ink variations and wear effects), Braille (Unicode patterns with 2x4 dot grids), and Edge ASCII (Sobel edge detection with directional characters). Includes post-processing effects: scanlines, CRT curvature, vignette, chromatic aberration, noise, flicker, and phosphor glow. Supports fullscreen, circle, and rectangle cursor-following layouts

Screenshots

image

image

Installation

Velopack Installer (Recommended)

The easiest way to install MouseEffects with automatic updates:

  1. Download MouseEffects-win-Setup.exe from Releases
  2. Run the installer - no administrator rights required
  3. The app installs to your user profile and updates automatically

Features:

  • No admin rights needed
  • Automatic background updates
  • Delta updates (only downloads changes)
  • Silent or notify update modes

Portable Version

For a no-install portable version:

  1. Download MouseEffects-{version}-win-full.nupkg from Releases
  2. Rename to .zip and extract to any folder
  3. Run MouseEffects.App.exe

From Source

See the Building from Source guide.

Quick Start

  1. Launch MouseEffects from the Start menu
  2. The app starts minimized to the system tray
  3. Right-click the tray icon to access settings
  4. Enable/disable effects and adjust their parameters
  5. Effects render immediately on your screen

System Requirements

  • OS: Windows 10 (1803+) or Windows 11
  • Graphics: DirectX 11 compatible GPU
  • Runtime: .NET 8.0 (included in MSIX package)

Documentation

Comprehensive documentation is available in the Wiki:

Project Structure

MouseEffects/
├── .github/
│   └── workflows/                # GitHub Actions CI/CD
│       └── release.yml           # Automated release workflow
├── src/                          # Core application
│   ├── MouseEffects.Core/        # Interfaces and base classes
│   ├── MouseEffects.DirectX/     # DirectX 11 rendering
│   ├── MouseEffects.Input/       # Mouse input handling
│   ├── MouseEffects.Overlay/     # Overlay window management
│   ├── MouseEffects.Plugins/     # Plugin loading system
│   └── MouseEffects.App/         # Main application
├── plugins/                      # Built-in effect plugins
│   ├── MouseEffects.Effects.ParticleTrail/
│   ├── MouseEffects.Effects.LaserWork/
│   ├── MouseEffects.Effects.ScreenDistortion/
│   ├── MouseEffects.Effects.ColorBlindness/
│   ├── MouseEffects.Effects.ColorBlindnessNG/
│   ├── MouseEffects.Effects.RadialDithering/
│   ├── MouseEffects.Effects.TileVibration/
│   ├── MouseEffects.Effects.WaterRipple/
│   ├── MouseEffects.Effects.Zoom/
│   ├── MouseEffects.Effects.Firework/
│   ├── MouseEffects.Effects.Invaders/
│   └── MouseEffects.Effects.ASCIIZer/
├── packaging/                    # MSIX packaging files
└── Wiki/                         # Documentation

Contributing

Contributions are welcome! Please read the Architecture Guide to understand the codebase structure before submitting pull requests.

Creating Plugins

MouseEffects has a powerful plugin system. See the plugin development guides:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Support the Project

If you find MouseEffects useful, consider supporting its development:

Donate with PayPal

Your support helps keep this project alive and enables new features!


❤️ Made with love and Claude.ai ❤️