Skip to content

Latest commit

 

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenMouse Background Service

A background app that lets OpenMouse switch your mouse's polling rate the instant a game launches, even with the browser closed.

A browser tab can't see what's running on your desktop, so it can't react to a game launching on its own. This app covers that one gap. Everything else (DPI, status, all other settings) still happens on the website.

How it works

  1. Open the OpenMouse website with a supported mouse connected. Game Mode turns itself on, at 1000 Hz idle and 4000 Hz in game, and you can change either rate on the Background Service page.
  2. The site records the exact HID bytes your mouse's own driver already sends to set those rates, and hands that recipe to this app once.
  3. This app watches for a game to start, either automatically or from your own list, and replays the matching recipe to the mouse.

Supported now: Razer (Viper V3 Pro / V4 Pro), Finalmouse ULX series, Teevolution, Lamzu, WLMouse, ATK, VGN, Pulsar.

Install

Download OpenMouseCompanion-Setup.exe from Releases and run it. No admin prompt: everything here works for a normal user account. It installs to your user profile, adds a Start Menu entry and an uninstaller, and starts at login from then on.

There are no prompts to click through. Only the OpenMouse website can talk to this app: the allowed origins are compiled in, and the browser sends an Origin header that page JavaScript cannot forge. Your browser will ask once for permission to reach a local address, which is a browser prompt rather than one of ours.

Tray menu

Right-click the tray icon to check for updates, open the log folder, change auto-start, pick the Game Mode icon colour, or quit. The OpenMouse Background Service page manages game detection, the manual game list, notifications, and per-mouse Game Mode settings.

The tray icon turns your accent colour while a game is running and goes back to white when it is not, and hovering it shows the rate currently in force.

Updates use the latest GitHub Release. The service downloads both the installer and its .sha256 file, verifies the installer, runs it silently, and restarts with the new version.

Building from source

dotnet build src/OpenMouseCompanion.csproj -c Release
dotnet publish src/OpenMouseCompanion.csproj -c Release -r win-x64 --self-contained true -o publish

Build the installer (requires NSIS):

makensis installer/OpenMouseCompanion.nsi

Run the self-checks (exit code 0 passes, no hardware needed):

"OpenMouse Background Service.exe" --self-test

About

Local companion app that lets OpenMouse switch your mouse's polling rate automatically when a game launches.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages