Mouse Binder

Mouse Binder is a small Windows helper that turns Mouse4 into a usable Wispr Flow shortcut while suppressing the original Browser Back action. It was built for Logitech side buttons that cannot be configured reliably through the manufacturer's software.

The default binding is:

• Source: Mouse Back / Mouse 4 (XButton1)
• Target: Left Shift + F13
• Original Browser Back action: blocked

The target keys stay down for exactly as long as the mouse button is held, so Wispr Flow push-to-talk works correctly.

Install

Download MouseBinder-Setup-1.0.0.exe from the latest GitHub release. The branded setup:

• Installs for the current user without requiring administrator rights.
• Adds Mouse Binder to the Start Menu.
• Starts Mouse Binder automatically whenever that user signs in.
• Registers a standard Windows uninstaller under Settings → Apps.

Each release also includes an MSI for managed or silent deployment.

After installation, launch Mouse Binder from the Start Menu once to review the binding. Closing its window keeps it active in the notification area.

Use the portable app

Build the standalone executable with scripts\publish.ps1, then:

1. Run dist\standalone-win-x64\MouseBinder.exe.
2. Leave the defaults or click Record to capture the same shortcut configured in Wispr Flow under Settings → General → Shortcuts.
3. Click Save and apply.
4. Hold the side button to dictate; release it to stop.

The close button hides Mouse Binder to the notification area. Right-click its tray icon to disable it temporarily or exit.

If the button does nothing, set the Logitech button to No action / Off / None in Logi Options+, fully exit Options+, and retry. If the button is exposed as a keyboard-style media action rather than Mouse 4, select Browser Back key (emitted by mouse software) as the source.

Use Clear for block-only mode. This disables the global Back action without sending any replacement shortcut.

Use the Shift+F13 preset to give Mouse 4 a dedicated keyboard chord:

1. Select Mouse Back / Mouse 4 as the source and click Shift+F13.
2. Keep Block the original Back/Forward action enabled and save.
3. Open Wispr Flow's shortcut recorder and press Mouse 4. Flow will record Shift+F13.

Windows' standard input-injection API supports only Mouse 4 and Mouse 5 as synthetic extra mouse buttons, so higher virtual mouse buttons such as Mouse 12 would require a separate virtual HID driver. Shift+F13 avoids that driver and does not trigger normal browser behavior.

Mouse Binder runs as the current user and does not need administrator access. Windows prevents a non-elevated process from injecting input into an elevated application, so run Mouse Binder elevated only if Wispr Flow itself is elevated.

Settings are stored at:

%LOCALAPPDATA%\MouseBinder\settings.json

Build

Requirements: Windows and the .NET 8 SDK.

dotnet build .\MouseBinder.sln
.\scripts\publish.ps1
.\scripts\build-installer.ps1

The publish script creates a self-contained, single-file Windows x64 executable under dist\standalone-win-x64, so the target PC does not need .NET installed. The installer script creates the branded MouseBinder-Setup-1.0.0.exe and a deployment-friendly MouseBinder-Setup-1.0.0.msi under dist\installer.

How it works

The app uses the documented Windows WH_MOUSE_LL and WH_KEYBOARD_LL hooks to observe the selected input globally. Matching press and release messages are suppressed when requested, and SendInput emits the configured target chord. It is a user-mode utility rather than a kernel driver.