A Windows desktop tool for real-time mouse customization, built for aim trainers and competitive gaming. Intercepts raw mouse input at the kernel level via the Interception driver and applies modifications before they reach any game or application.
Five independent modules — run any combination, or none (pass-through):
| Module | What it does |
|---|---|
| Sensitivity | Applies unified or independent horizontal and vertical multipliers |
| Sensitivity Randomizer | Randomizes your sensitivity on a configurable curve during practice sessions |
| Acceleration Curve | Maps axial mouse speed (mm/s) to sensitivity multipliers via custom curves |
| Angle Correction | Rotates raw input to compensate for physical mouse grip tilt |
| Angle Snapping | Snaps movements to the nearest 90° axis for drawing straight lines |
- Windows 10/11 x64
- Secure Boot must be disabled (required by the Interception driver)
- Anti-Cheat Compatibility: See Anti-Cheat & Vanguard below.
- Visual Studio 2022 with "Desktop development with C++" (to build from source)
- Node.js 18+ (to build from source)
Warning
The Interception driver is currently blacklisted by Riot Vanguard.
If you have Vanguard installed (Valorant / League of Legends), the driver will be blocked from loading at system startup. This results in the app showing a "Driver Offline" status even if installation was successful.
To use this app on a Vanguard system:
- Disable Vanguard (Right-click tray icon -> Exit Vanguard).
- Reboot. The driver can only load at boot-time if Vanguard is not active.
- To play Vanguard-protected games again, you must re-enable Vanguard and reboot (which will disable this app's driver).
Other anti-cheats (EAC, BattlEye) may also flag or block the Interception driver. Use at your own risk in competitive environments.
- Run
TheMouse.app Setup.exe— or use the portablewin-unpacked\folder directly. - On first launch the app installs to the system tray and enables auto-start.
- Go to Settings → Interception Driver → Install Driver and follow the UAC prompt.
- Reboot. The driver requires a reboot to activate.
- Configure your modules and hit Start from the Dashboard.
.\build.ps1 # full build: C++ → Vite → electron-builder
.\build.ps1 -SkipCpp # UI only (C++ already built)
.\build.ps1 -SkipUi # C++ onlyOutput lands in build\ — win-unpacked\ for the portable version and TheMouse.app Setup.exe for the installer.
Applies a constant multiplier to your mouse movement. Supports both linked and independent axis control.
- Linked Mode — a single slider controls both X and Y axes for perfect uniformity.
- Decoupled Mode — set independent horizontal and vertical multipliers. Useful for aspect ratio corrections (e.g. 16:9 → 4:3) or fine-tuning vertical feel.
| Setting | Default | Description |
|---|---|---|
X_Sensitivity |
1 |
Horizontal axis multiplier |
Y_Sensitivity |
1 |
Vertical axis multiplier |
Randomizes your sensitivity multiplier over time using a stateful random walk. Two modes:
- Smooth — continuous Gaussian-filtered curve, gradual and flowing transitions
- Step — discrete jumps held for a configurable number of seconds
Designed for aim trainers like Kovaak's. Varying sensitivity during practice builds adaptability and fine motor control beyond what a fixed sensitivity can.
| Setting | Default | Description |
|---|---|---|
Baseline_Sensitivity |
1 |
Center of the randomization range |
Min_Sensitivity |
0.5 |
Lower bound multiplier |
Max_Sensitivity |
2 |
Upper bound multiplier |
Spread |
0.1 |
Lognormal variance — how far sensitivity wanders from baseline |
Smooth |
1 |
1 = smooth mode, 0 = step mode |
Smoothing |
5 |
Smooth mode only. 0 = raw noise, 5 = maximum smoothing |
Timestep |
3 |
Step mode only. Seconds each value is held |
Maps raw mouse speed (mm/s) to a sensitivity multiplier using custom curves. Features True Axial Independence — horizontal and vertical multipliers are calculated based on their own axial velocities.
Editor features:
- Split X/Y Mode: Draw completely independent curves for horizontal and vertical acceleration.
- Visibility & Locking: Toggle visibility or lock curves to edit one without affecting the other.
- Professional Visualizer: High-fidelity live dots with trails, crosshairs, and axis labels show your exact speed and multiplier in real-time (30Hz).
- Point Types: Smooth (Hermite spline), corner (linear), and jump (step) — double-click to cycle.
- Interaction: Scroll to zoom, middle-drag to pan, Shift to snap to grid.
Compensates for physical mouse grip tilt. If you hold your mouse at an angle, straight physical movements become diagonal on screen — this rotates the raw input back to align with your hand.
- Interactive dial — drag to set rotation visually, or type an exact value
- Range: -180° to +180°
- Applied first in the pipeline, before sensitivity and acceleration
| Setting | Default | Description |
|---|---|---|
Angle_Enabled |
0 |
1 = rotation active |
Angle_Value |
0 |
Degrees of rotation (-180 to 180) |
Assists in drawing perfectly straight horizontal or vertical lines by ignoring small axial deviations.
- Threshold control — adjust how "sticky" the axes feel (1° to 45°)
- Snaps to the nearest 90-degree axis (0°, 90°, 180°, 270°)
- Direction is determined from a rolling average of recent movement, so integer quantization of individual mouse events doesn't defeat the snap at low speeds
- Ideal for creative work or specific aim-training scenarios where axial consistency is required
| Setting | Default | Description |
|---|---|---|
Snap_Enabled |
0 |
1 = snapping active |
Snap_Threshold |
20 |
Maximum deviation in degrees to snap to axis |
Directly control Windows system-level settings within the app:
- Enhance Pointer Precision: Toggle the built-in Windows mouse acceleration.
- Pointer Speed: Adjust the base Windows sensitivity (1-20).
Configurable system-wide shortcuts.
- State Persistence: The app remembers if the engine was active and automatically resumes on startup.
- Auto-Recovery: Automatically repairs or regenerates
settings.iniif it becomes missing or corrupted. - Migration: Seamlessly merges new features and defaults when upgrading from older versions.
- Start / Stop from the Dashboard, system tray, or via Ctrl+F12.
- Close hides to tray. Right-click tray icon → Quit to exit fully.
- Apply settings to restart the driver and activate changes.
The Interception driver requires:
- Secure Boot disabled in BIOS/UEFI
- A reboot after install before the driver is active
- Admin privileges only for install/uninstall — normal use requires no elevation
When the app is stopped, the Interception driver is a transparent pass-through — your mouse behaves completely normally.
The sensitivity randomizer engine originated from Whisper & El Bad. This project has since grown into a standalone mouse customization tool and is maintained independently.