Repolode
Submit
OpenMouse-Project

OpenMouse-Project/openmouse

A browser-based control panel for supported gaming mice to view device info and change settings like DPI and polling rate without vendor-specific apps.

Open-source alternative to:Razer SynapseLogitech G HUB

View on GitHubWebsite
Stars
2,547
Forks
171
Open issues
27
Last commit
2 days ago

What is it?

OpenMouse is a web control panel for supported gaming mice. Connect a mouse and it shows device information and lets you change supported settings such as DPI and polling rate, without installing a separate driver application for each brand.

It runs in Chromium-based browsers that support WebHID, so devices are accessed directly from the page. The project includes a Bridge component that can carry HID reports over a loopback connection when available, and a Games page for per-game profiles when Bridge is connected.

Device codecs and drivers live in the separate @openmouse/protocol library, which the control panel consumes through its public exports. The project is written in TypeScript and licensed under AGPL-3.0.

Key features

  • 01Shows connected mouse information in the browser.
  • 02Adjusts supported settings such as DPI and polling rate.
  • 03Uses WebHID in Chromium-based browsers, with no per-brand app needed.
  • 04Optional Bridge component provides a loopback HID transport.
  • 05Device drivers are provided by the separate @openmouse/protocol library.

Use cases

  • Changing DPI or polling rate on a supported gaming mouse without installing vendor software.
  • Checking a mouse's device information from a browser on a machine where a vendor app is unavailable.
  • Contributing new mouse drivers or testing supported hardware.

Quick start

  1. 1

    Install dependencies

    npm install
  2. 2

    Start the development server

    npm run dev
  3. 3

    Open the control panel in a Chromium-based browser with WebHID support and connect a mouse

Things to know

  • Requires a Chromium-based browser with WebHID support.
  • Linux users may need custom udev rules to access some devices, such as VXE R1 SE+.
  • Licensed under AGPL-3.0, a copyleft license with network-use obligations.

Topics

#gaming-mouse#webhid#hardware#typescript#dpi#peripherals

FAQ

What is openmouse?
A browser-based control panel for supported gaming mice to view device info and change settings like DPI and polling rate without vendor-specific apps. OpenMouse is a web control panel for supported gaming mice. Connect a mouse and it shows device information and lets you change supported settings such as DPI and polling rate, without installing a separate driver application for each brand.
Is openmouse free to use? What license does it have?
openmouse is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is openmouse still maintained?
Actively maintained. The last commit to openmouse was on Oct 18, 2026.
What can I use openmouse for?
Changing DPI or polling rate on a supported gaming mouse without installing vendor software. Checking a mouse's device information from a browser on a machine where a vendor app is unavailable. Contributing new mouse drivers or testing supported hardware.
How do I install openmouse?
Install dependencies: npm install Start the development server: npm run dev Open the control panel in a Chromium-based browser with WebHID support and connect a mouse
Where can I get openmouse?
The source code and installation instructions are on GitHub: https://github.com/OpenMouse-Project/openmouse

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

Related projects