Windows Inertial Mouse Driver

A Windows KMDF HID mouse filter driver that turns physical mouse movement into inertial cursor motion. Moving the mouse adds velocity; when the mouse stops, the cursor keeps moving and slows down by friction until it settles.

The active implementation lives in src/inertialmouse. The installer lives in src/installer and is packaged as a single executable.

Project page:

https://cervantesh.github.io/windows-inertial-mouse-driver/

Latest release:

https://github.com/cervantesh/windows-inertial-mouse-driver/releases/tag/v1.0.0

This project is for local driver development and testing. The driver uses a test certificate, so Windows test-signing is required unless the package is signed through a production driver-signing flow.

• Kernel-mode HID mouse upper-filter driver.
• Physical relative mouse movement adds to persistent virtual velocity.
• KMDF timer applies friction and emits continued cursor movement.
• Per-device registry configuration seeded by the INF.
• Traditional Windows setup wizard for install, uninstall, and test-signing cleanup.
• Small single-file installer bootstrapper with .NET 10 Desktop Runtime support.

Install the current Visual Studio 2022 + WDK toolchain:

.\scripts\install-modern-toolchain.ps1 -IncludeVsCommunity

Build the driver:

.\scripts\build-inertialmouse.ps1

Build the single-file installer:

.\scripts\build-installer.ps1

The generated installer is:

dist\InertialMouseInstaller.exe

Run the installer as Administrator:

dist\InertialMouseInstaller.exe

The wizard detects connected HID mice, recommends the active mouse, installs the filter, and registers a normal Windows uninstall entry.

After installation, restart Windows before testing the mouse.

Use the Windows uninstall entry or run:

.\scripts\uninstall-inertialmouse.ps1

To also disable test-signing:

.\scripts\uninstall-inertialmouse.ps1 -DisableTestSigning

The INF seeds these DWORD values under the device Device Parameters key: