Detecting the mouse
Prev
Next

## Detecting the mouse

This section describes how you can detect your mouse with btnx-config.

You can start the mouse detection by pressing the Detect mouse and buttons button at the Configuration Manager window of btnx-config. If you haven't detected your mouse yet, it will open the mouse detection window.

### Quick guide:

1. Press the Press to start mouse detection button.

2. Wait until told to move your mouse.

3. Move your mouse and press all its buttons.

4. Press Forward

### In depth guide:

To start the mouse detection, press the Press to start mouse detection button. At this point, do not interact with any of your input devices. This means, do not move your mouse, press its buttons, press any keyboard buttons, etc. After a couple of seconds, you are told to move your mouse.

btnx-config mouse detection

Now, move your mouse. btnx-config should have detected your mouse. The Detected handlers should have increased to one, and the Vendor ID and Product ID labels should have been set to something other than 0x0000.

btnx-config mouse detection complete

Make sure to press each button on your mouse. This isn't necessary for most mice. However, some mice, like the Logitech MX Revolution, have additional handlers for some buttons. All these handlers must be detected in order for those buttons to work correctly.

You can press the Press to stop mouse detection button to stop the mouse detection, or press Forward to proceed to the next step. You can also stop the mouse detection and revert all changes by pressing Undo. Another way is to stop the mouse detection and start it again.

When you are done detecting the mouse, press Forward to go to the button detection phase. If you press Cancel, all changes are discarded and the detection wizard closes.

If you encountered any errors or problems during the mouse detection, refer to the Troubleshooting section of this manual.

If you get the "Device ID conflict detected" error window as seen below, refer to the Device ID conflict section in Troubleshooting.

btnx-config device ID conflict

Prev
Next
Home
Running btnx-config
Detecting buttons
Up

Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team