Skip to content

Gearwise ​

Gearwise is one app for setting up gaming mice and keyboards from Logitech, Razer, Corsair and SteelSeries. You change DPI, lighting, button assignments, report rate and macros in one window, on Linux or Windows, without the vendor's own software.

The Gearwise window showing the Assignments tab for a Logitech G502 HERO demo device
  1. 1Devices — Every connected mouse and keyboard, with its brand, connection and battery level. Select one to configure it.
  2. 2Tabs — Assignments, Sensitivity, Lighting, Performance and Info for the selected device.
  3. 3Save to profile and Save to device — Store the current settings in the active profile, or write them to the memory of the device.
  4. 4Onboard profile — The numbered profile slots stored inside the device. Select a number to switch.
  5. 5Device picture — A drawing of the device with every button labelled. Select a label to change that button.
  6. 6Buttons — The same buttons as a list. The selected button opens a panel where you pick its action.
  7. 7Library — Profiles, Macros and Settings, shared by all devices.
  8. 8Active profile — The profile that records your changes. Select it to switch to another one.

Who it is for ​

  • Linux users whose mouse or keyboard has no vendor software for their system.
  • Windows users who want one small app instead of G HUB, Synapse, iCUE and GG.
  • Anyone who wants to try the controls first: the app has demo devices that need no hardware.

What it does ​

  • Sensitivity. Up to five DPI stages, an active stage, and separate X and Y values where the sensor allows it.
  • Lighting. Effects per lighting zone (the effects your device supports), colour, speed and brightness, and per-key painting on RGB keyboards.
  • Assignments. Give a button another mouse button, a keystroke with modifiers, a media key, a DPI function, a profile switch or a macro, or turn it off.
  • Performance. Report rate, lift-off distance, angle snapping and keyboard game mode, where the device has them.
  • Onboard profiles. Switch between the profile slots stored in the device and save settings to them.
  • Macros. Record or build a sequence of key presses, mouse clicks, delays and text, then put it on a button.
  • Profiles. A profile remembers your settings for each device model and applies them again when the device connects. A profile can also switch on when a chosen program comes to the front.

Gearwise is a single native program. It has no background service and needs no account.

Platforms ​

PlatformReleased builds
LinuxUbuntu PPA, .deb package and a tarball for x64 (x86-64). Needs glibc 2.35 or newer (Ubuntu 22.04 or newer).
WindowsA zip for x64 PCs.

See Install for the commands.

Supported hardware ​

BrandWhat is covered
LogitechG-series and MX devices that speak HID++ 2.0: wired, through Lightspeed, Unifying and Bolt receivers, and over Bluetooth
Razer34 models from the DeathAdder, Viper, Basilisk, Naga, Cobra, BlackWidow, Huntsman and Ornata families
CorsairAbout 45 mice and keyboards, such as M65, Dark Core, Katar, Harpoon, Scimitar, K55, K65, K70, K95 and K100
SteelSeriesMice from the Rival, Sensei, Aerox and Prime families

The full list is in the reference.

Good to know

So far the project has tested three devices on real hardware: the Logitech G502 HERO (wired), the Lightspeed receiver and the Corsair K55 RGB PRO. Support for the other models follows published protocol descriptions and is checked with automated tests against emulated devices. If your device misbehaves, report it on the issues page.

Next steps ​