Repolode
Submit
sqmw

sqmw/MFCMouseEffect

Cross-platform mouse effects and input visualization engine with click, trail, scroll and hover effects, key/mouse indicator overlays, and WASM plugins.

View on GitHub
Stars
864
Forks
55
Open issues
19
Last commit
3 months ago

What is it?

MFCMouseEffect is a desktop tool that draws visual feedback around mouse input. It offers five effect channels: clicks, drag trails, scroll feedback, long-press charging and hover glow, along with a companion pet that follows the cursor.

It also includes an input indicator overlay that shows mouse clicks, wheel direction and keyboard shortcuts such as Cmd+Tab, which is useful for screen recordings and tutorials. Mouse actions, wheel input and gestures can be mapped to hotkeys, delays, URLs or application launches. Effects and indicators can be extended with WASM plugins, while the host controls rendering and resource budgets. Settings are exposed through a shared Svelte-based web settings page.

Windows is the most complete platform, macOS is the current main development line, and Linux is in a follow-up state. macOS requires Accessibility and Input Monitoring permissions to capture global input.

Key features

  • 01Five independent effect channels: click, trail, scroll, long-press and hover.
  • 02Keyboard and mouse indicator overlay for showing shortcuts and clicks.
  • 03Mapping of mouse actions, wheel and gestures to hotkeys, delays, URLs and app launches.
  • 04Extensible WASM plugin runtime for custom effects and indicators.
  • 05Shared Web settings interface across platforms.

Use cases

  • Adding visible click and keystroke feedback to screen recordings or live demos.
  • Creating tutorial videos that show which keys and clicks were pressed.
  • Mapping gestures to shortcuts for desktop productivity.
  • Building custom mouse effects with WASM plugins in a C++ host.

Quick start

  1. 1

    Windows: open MFCMouseEffect.slnx in Visual Studio and build Release | x64

  2. 2

    Windows: build with the wrapper command

    .\mfx.cmd build
  3. 3

    macOS: build the project

    make build
  4. 4

    macOS: compile and launch the app

    ./mfx run

Things to know

  • macOS needs Accessibility and Input Monitoring permissions to capture global input.
  • The macOS package is unsigned and may be blocked by Gatekeeper on first launch.
  • Windows is the most complete platform, while Linux only follows along with build and contract checks.

Topics

#mouse-effects#input-visualization#wasm#plugins#hotkeys#automation#gesture-recognition#cross-platform#linux#macos

FAQ

What is MFCMouseEffect?
Cross-platform mouse effects and input visualization engine with click, trail, scroll and hover effects, key/mouse indicator overlays, and WASM plugins. MFCMouseEffect is a desktop tool that draws visual feedback around mouse input. It offers five effect channels: clicks, drag trails, scroll feedback, long-press charging and hover glow, along with a companion pet that follows the cursor.
Is MFCMouseEffect free to use? What license does it have?
MFCMouseEffect is open source under the MIT license. Check the license terms before using it in commercial products.
Is MFCMouseEffect still maintained?
Updated within 6 months. The last commit to MFCMouseEffect was on Jul 26, 2026.
What can I use MFCMouseEffect for?
Adding visible click and keystroke feedback to screen recordings or live demos. Creating tutorial videos that show which keys and clicks were pressed. Mapping gestures to shortcuts for desktop productivity. Building custom mouse effects with WASM plugins in a C++ host.
How do I install MFCMouseEffect?
Windows: open MFCMouseEffect.slnx in Visual Studio and build Release | x64 Windows: build with the wrapper command: .\mfx.cmd build macOS: build the project: make build macOS: compile and launch the app: ./mfx run
Where can I get MFCMouseEffect?
The source code and installation instructions are on GitHub: https://github.com/sqmw/MFCMouseEffect

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects