A lightweight control app for gaming mice. One small native program for Windows and Linux instead of a heavy vendor suite: set DPI, report rate, lighting and buttons, watch the battery, and see how much you click. An open-source alternative to Razer Synapse, Logitech G Hub and similar mouse software.
- Battery in the window and the tray icon, with a runtime estimate.
- DPI stages with colours, a quick switch on the overview.
- Performance: report rate, debounce, lift-off distance, sleep timer, and a live measurement of the real report rate.
- Lighting effects, brightness, speed and direction.
- Buttons and macros: remap any button.
- Statistics for any mouse: clicks, wheel, distance, battery history.
- 9 colour themes or the system one, 13 languages, no account, no telemetry.
What a mouse offers depends on its driver; screens it does not support are hidden.
| DPI stages | Statistics |
|---|---|
![]() |
![]() |
| Level | Meaning | Mice |
|---|---|---|
| Supported | Tested on the mouse | White Shark Lionel, Logitech M705, Logitech M510 |
| Partial | Some functions, tested | Eternico AET-MS480B (battery, DPI stage) |
| Experimental | Written from protocol documentation, not yet tested on the mouse | 180+ models: Logitech (HID++ 2.0), Razer, SteelSeries, Corsair, ASUS ROG, Roccat, Glorious, ATK, VXE / VGN / Lamzu |
| Statistics only | Any other mouse | clicks, wheel and distance; battery over Bluetooth where available |
The full list is in data/mice.toml. If you own an experimental mouse, please tell us whether it works: About → Help add your mouse reads the mouse, runs a few guided checks and opens a prefilled GitHub issue.
Download the file for your system from Releases or whisker.emlynix.com.
Windows 10 / 11 – whisker-windows-x86_64.exe. Run it; no installer is
needed. Settings → General → Install copies it to your user programs and
adds a Start menu entry and optional start at sign-in.
Linux (x86-64) – whisker-linux-x86_64. Needs GTK 3; the tray icon
needs libayatana-appindicator3 (or libappindicator3).
chmod +x whisker-linux-x86_64 && ./whisker-linux-x86_64Talking to a mouse needs access to its hidraw device. Whisker shows the
exact command when access is missing; it installs
bundle/linux/70-whisker.rules, which gives
the logged-in user access to mice of the supported brands only.
Whisker works offline. The only connection it makes on its own is a daily update check
(on by default, off in Settings → General): an HTTPS request to
whisker.emlynix.com, or GitHub as a fallback, that sends your IP address
and the app version. Updates are verified against a SHA-256 hash and an
ECDSA signature before they replace the app. Settings and statistics stay
on your computer.
Whisker keeps a small diagnostic log (log.txt next to its settings, at
most 256 KB): start-up, connected mice by USB id, what the driver did,
crashes and hangs. No serial numbers, Bluetooth names, key presses or
clicks. It never leaves your computer unless you copy or send it yourself.
Send, in the mouse report and after a crash, uploads exactly the text
shown above the button to whisker.emlynix.com (HTTPS), together with
your IP address and the app version. Nothing is sent without that click.
Sent reports are kept for 12 months, then deleted.
A proxy set in the system (or HTTPS_PROXY on Linux) sees these requests
like any other.
Rust 1.85 or newer (edition 2024).
cargo build --release- Linux: install the GTK 3 development package first
(
libgtk-3-devon Debian / Ubuntu,gtk3-develon Fedora).
Run the tests with cargo test.
Bug reports, mouse reports and pull requests are welcome; see CONTRIBUTING.md. Code contributions need a signed Contributor License Agreement.
Protocol facts come from the documentation and sources of OpenRazer, Solaar, libratbag, rivalcfg, ckb-next, OpenRGB and G-Helper. Whisker's code is written from scratch. Brand names belong to their owners; Whisker is not affiliated with any mouse maker.
Copyright © 2026 Emlynix s.r.o.
Whisker is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3 or (at your option) any later version. It comes without any warranty.


