Troubleshooting and FAQ
Each heading below is a symptom or a question. Find yours, then read the cause and the fix.
Troubleshooting
My device does not appear
- Not supported. Check the list of supported devices. Logitech devices must use HID++ 2.0, which most G-series and MX devices from recent years do.
- Wireless device asleep. Move the mouse or press a key to wake it, then select Scan again.
- On Linux, no permission. See the next question.
- On Windows, the vendor's software is running. See The device is listed but settings do not change.
A banner says devices could not be opened
On Linux, the banner begins with the number of devices and reads Install the udev rules, then reconnect the device:. Your user account is not allowed to open the device. Install the udev rule as shown in Set up Linux permissions, then unplug the device and plug it in again.
On Windows, the banner asks you to close Logitech G HUB, Razer Synapse or Corsair iCUE and reconnect the device. Those programs can hold a device for themselves.
The device is listed but settings do not change
Another program may be controlling the device. Close Logitech G HUB, Razer Synapse, Corsair iCUE and SteelSeries GG, including their icons in the system tray, then unplug the device and plug it in again. On Linux, close other tools that configure the same device, such as Solaar, Piper or OpenRGB.
My settings are gone after I restart the computer
Settings made in Gearwise are recorded in the active profile and applied again when Gearwise starts and finds the device. If Gearwise is not running, the device uses whatever is stored in its own memory.
To keep settings without Gearwise, select Save to device. See Use onboard profiles.
My macro does not play
- Gearwise is not running. Macros are played by Gearwise, so it must stay open.
- The device cannot run macros. In this release macros work on Logitech devices only.
- On Linux,
/dev/uinputis missing or closed. Load it withsudo modprobe uinputand check that the udev rule is installed. - Steps go to the wrong window. Macros send keys to the window in front. Click the window you want first.
The Assignments tab says this device has no configurable buttons
Button remapping is not supported for Razer and Corsair devices in this release. It works on Logitech and SteelSeries mice.
Profiles do not switch when I start a game
- Check that Switch profiles automatically is turned on, and that the program is listed under Linked applications with its exact name.
- On Linux, automatic switching needs an X11 session. On Wayland, switch profiles by hand from the Active profile box at the bottom of the sidebar.
The Sensitivity or Lighting tab is missing
Gearwise shows only the tabs a device supports. Keyboards have no Sensitivity tab, and a device without lights has no Lighting tab. The Info tab lists what Gearwise found.
Questions
Do I need the vendor's software as well?
No. Gearwise talks to the devices directly. Do not run both at the same time.
Does Gearwise run in the background?
No. Gearwise has no background service. Settings that live in the device keep working when Gearwise is closed; macros and automatic profile switching need Gearwise open.
Does Gearwise need an account or internet access?
No. It needs no account and works offline.
Can I try Gearwise without a supported device?
Yes. Select Show demo devices on the start screen, or turn it on under Settings. Demo devices are simulated and never touch real hardware.
Can I move my settings to another computer?
Export a profile under Profiles, then import it on the other computer. Or save your settings to the device with Save to device, so they travel with it.
Is there a Flatpak or Snap?
No. The released builds are the Ubuntu PPA, a .deb, a tarball and a Windows zip. See Install.
Where do I report a problem?
Open an issue on the Gearwise issues page. Include the device name, how it is connected, and what the Info tab shows.