Question

1.

The mouse sends extra events events when pressing a button.

Answer 1

If you are getting multiple and identical events during one button press, check this section first. The list below gives some possible reasons and solutions to the problem.

The button could already be recognized and handled by X. You can confirm this by running xev (see "Running xev") without btnx. A possible solution is to edit your xorg.conf file's mouse InputSection. Refer to this section for a working xorg.conf InputSection.
If you are using a mouse that has Cruise Control or Smart Scroll functionality, lomoco might help. See the troubleshooting section on lomoco.
Remove any custom udev rules that you have made for the mouse.
If the solutions above didn't work, you could try using xmodmap to map the buttons to harmless button numbers. First, use xev (see "Running xev") to find out what extra mouse button number is sent. Then, use xmodmap (see "xmodmap") to change the number to a higher one. The higher button numbers usually aren't handled by window managers, so nothing extra happens when they are called.

Answer 2

A couple of possible solutions:

Make sure your mouse is recognized as a USB input device. See this part for more info.
Remove any custom udev rules that you have made for the mouse.
It's possible that some buttons use a different event handler than the mouse itself. You must press each button on your mouse during mouse detection to ensure that all event handlers have been detected.
You might have incompatible settings in your xorg.conf file (see xorg.conf section). If you are using the evdev driver, you are certain to run into problems.
If you have mouseemu installed, try removing it.

Answer 3

This error means that mouse detection detected more than one input device. btnx only supports a single input device at a time, currently. btnx-config uses Vendor and Product IDs to identify different input devices.

Make sure you only use your mouse during mouse detection. Do not press any keyboard buttons. If you have multiple mice, only move the one that you want detected. Do not interact with any other possible input devices.

If your mouse has multiple event handlers and each uses a different set of Vendor and Product IDs, then btnx cannot help you. If the problem happens when you press a certain button, then leave that button alone and do not use it with btnx.

Answer 4

There are a couple of possible solutions.

You pressed multiple buttons during button detection. Close the error window by pressing Cancel and try again. Only press a single button repeatedly during detection.
You tried to detect a previously detected button. The "Already assigned" column is set to "Yes" for that button in the error window. Close the error window by pressing Cancel and try a different button next time.
Your button sends multiple events when pressing it. This true for mice with SmartScroll or Cruise Control and lomoco can fix the problem (see "Installing lomoco"). If you don't want to use lomoco, or lomoco won't help with your mouse, use the following steps:
1. Bind the button to a certain rawcode suggested by the error window by selecting a row. You should choose the one with the most Clicks. You can only use entries which have their Already assigned field set to No. If it's set to Yes, the rawcode has already been detected and bound to a certain button.
2. Click OK to confirm the selection and close the window.
3. Configure and test the button.
4. If the button doesn't behave correctly, use the Delete button in the button configuration window to remove the button. Then, detect the button again and try binding it to a different rawcode. Rinse and repeat.

Answer 5

Make sure you have checked the Enabled check-box in btnx-config for every button that you want btnx to handle.
Make sure you have restarted btnx after making any changes to the configuration file. Either press the Restart btnx in btnx-config or run the following command in your terminal:
```
$ sudo /etc/init.d/btnx restart
```
It could be a problem with the btnx executable. First, stop btnx from command line and run it from the command line to see its output. Look for any errors.
```
$ sudo /etc/init.d/btnx stop
$ sudo btnx
```

Answer 6

Try enabling the Force immediate button release setting in the General button properties group.

This could also be a sensitivity problem with your mouse, or not. In any case, you should increase the delay value for that button in btnx-config (see Delay property). This will prevent the button from sending multiple events in a certain time frame.

Also, make sure only one btnx process is running at a time.

Answer 7

If you are upgrading from btnx-0.2.x, make sure you uninstall it first before installing the new version of btnx. Also, make sure you are not using the old (pre 0.3.0) configuration files. They no longer work.

Answer 8

Make sure you have enabled hot-plugging in the Advanced settings (see Enable hot-plugging). It is possible that btnx will not start correctly after standby if you have the WAIT_FOR_SYSFS setting enabled.

Answer 9

Disable the WAIT_FOR_SYSFS setting. If you do not need hot-plugging, you can also disable that setting. (see Enable hot-plugging)

Answer 10

Most problems with btnx arise from different xorg.conf InputSection settings. You want xserver to handle as little from the mouse as possible, the most fundamental behavior aside. In essence, you want to downgrade your xserver functionality in connection to the mouse. This is sometimes necessary, because btnx cannot stop xserver from handling mouse button events if it wishes to do so. You will then get multiple events, often with xserver doing what you don't want.

Most user's have found that changing the Driver, Protocol, and Device options to the reference values below has fixed their problems. Most importantly, make sure you are not using the evdev driver.

Warning

Laptop users should not edit their Synaptics touchpad settings.

Warning

Do not blindly copy the example below. Changing the Identifier in your xorg.conf might lead to an xserver startup failure.

Warning

Make sure you know how to edit the xorg.conf file. Make a backup of it before editing. You should know how to recover the backup file and restart from the command line in case you run into trouble.

Below is a working xorg.conf InputSection. Try to make yours look like it as much as possible, but don't change the Identifier value.

Section "InputDevice"
    Identifier     "Mouse0"
    Driver         "mouse"
    Option         "Protocol"        "auto"
    Option         "Device"          "/dev/psaux"
    Option         "ZAxisMapping"    "4 5"
EndSection

You may also try to use /dev/input/mice for the Device option.

You can edit your /etc/X11/xorg.conf by running the following command:

$ sudo gedit /etc/X11/xorg.conf

Save all your work and press Ctrl+Alt+Backspace to restart X. This will close your programs and your desktop!

Answer 11

Install xev if you don't have it. Run xev by typing

$ xev

Then, press the button which is giving you problems. For example, pressing the left mouse button outputs something like the following:

ButtonPress event, serial 29, synthetic NO, window 0x5000001,
root 0x137, subw 0x0, time 1050685211, (163,11), root:(173,108),
state 0x10, button 1, same_screen YES

Note the button number, button 1, reported by xev. The number will depend on the button you press.

You can also use xev to check whether btnx is sending the correct keys when pressing a mouse button. In this case, look for a keysym value.

Answer 12

xmodmap can be used to change the behavior of a button in X. This is sometimes useful for buttons that are interpreted by xserver and sending an event. A common problem is that a button also sends a right click, opening up a menu.

Use xev (see "Running xev") to find out what button number is being sent. Now, bind that button number to a higher one, one that is not handled by your window manager. Let's say a certain mouse button also sends a button number 6. The following shell command tells X to send a button 9 when it wants to send a button 6 event.

$ xmodmap -e "pointer = 1 2 3 4 5 9 7 8 6"

Note, that 6 and 9 have changed places. If that doesn't work, try switching to another number, like 8 or 7. Now, add the line that worked for you in your ~/.Xmodmap file. Using the previous example, you would add the following:

pointer = 1 2 3 4 5 9 7 8 6

This will make the change persist on reboots.

Answer 13

lomoco is useful if your mouse wheel sends extra button events when scrolling. Another problem is mice with Cruise Control. Some buttons might give multiple events when pressing them. Here are tim71's instructions for installing and using lomoco.

Install lomoco. If your system uses Debian packages and apt-get, you can probably get it by running
```
$ sudo apt-get install lomoco
```
If your system doesn't have binary packages (deb or rpm) for lomoco, you can find the sources at http://lomoco.linux-gamers.net/.
Run the following command to disable SmartScroll/Cruise Control:
```
$ sudo lomoco --no-sms
```
Tell your system to start lomoco during boot with the --no-sms. You should consult your distro's sources of help on how to do this. However, the following should work for most users. Add this line into your /etc/rc.local immediately before the line "exit 0".
```
lomoco --no-sms
```

Answer 14

btnx might not work correctly if your mouse is not recognized as a USB input device. Make sure you aren't using a USB->PS/2 adapter with your mouse. You can check that the mouse is reported as a USB device with the following command:

$ cat /proc/bus/input/devices

Now, find the section that refers to your mouse. The section should look something like this:

I: Bus=0003 Vendor=046d Product=c51a Version=0111
N: Name="Logitech USB Receiver"
P: Phys=usb-0000:00:02.0-4/input0
S: Sysfs=/class/input/input182
H: Handlers=mouse2 ts2 event4 
B: EV=7
B: KEY=ffff0000 0 0 0 0 0 0 0 0
B: REL=143

Check that the line starting with "P: Phys=" contains the word "usb". You can also check the output of that file to see if btnx registered correctly as an input device. Look for a section with Vendor=b216.

1.	The mouse sends extra events events when pressing a button.
	If you are getting multiple and identical events during one button press, check this section first. The list below gives some possible reasons and solutions to the problem. The button could already be recognized and handled by X. You can confirm this by running xev (see "Running xev") without btnx. A possible solution is to edit your `xorg.conf` file's mouse InputSection. Refer to this section for a working `xorg.conf` InputSection. If you are using a mouse that has Cruise Control or Smart Scroll functionality, lomoco might help. See the troubleshooting section on lomoco. Remove any custom udev rules that you have made for the mouse. If the solutions above didn't work, you could try using xmodmap to map the buttons to harmless button numbers. First, use xev (see "Running xev") to find out what extra mouse button number is sent. Then, use xmodmap (see "xmodmap") to change the number to a higher one. The higher button numbers usually aren't handled by window managers, so nothing extra happens when they are called.
2.	btnx doesn't recognize all my buttons.
	A couple of possible solutions: Make sure your mouse is recognized as a USB input device. See this part for more info. Remove any custom udev rules that you have made for the mouse. It's possible that some buttons use a different event handler than the mouse itself. You must press each button on your mouse during mouse detection to ensure that all event handlers have been detected. You might have incompatible settings in your `xorg.conf` file (see `xorg.conf` section). If you are using the evdev driver, you are certain to run into problems. If you have mouseemu installed, try removing it.
3.	Mouse detection gives me a "Device ID conflict detected" error.
	This error means that mouse detection detected more than one input device. btnx only supports a single input device at a time, currently. btnx-config uses Vendor and Product IDs to identify different input devices. Make sure you only use your mouse during mouse detection. Do not press any keyboard buttons. If you have multiple mice, only move the one that you want detected. Do not interact with any other possible input devices. If your mouse has multiple event handlers and each uses a different set of Vendor and Product IDs, then btnx cannot help you. If the problem happens when you press a certain button, then leave that button alone and do not use it with btnx.
4.	Button detection gives me a "Button detection problem" error.
	There are a couple of possible solutions. You pressed multiple buttons during button detection. Close the error window by pressing Cancel and try again. Only press a single button repeatedly during detection. You tried to detect a previously detected button. The "Already assigned" column is set to "Yes" for that button in the error window. Close the error window by pressing Cancel and try a different button next time. Your button sends multiple events when pressing it. This true for mice with SmartScroll or Cruise Control and lomoco can fix the problem (see "Installing lomoco"). If you don't want to use lomoco, or lomoco won't help with your mouse, use the following steps: Bind the button to a certain rawcode suggested by the error window by selecting a row. You should choose the one with the most Clicks. You can only use entries which have their Already assigned field set to No. If it's set to Yes, the rawcode has already been detected and bound to a certain button. Click OK to confirm the selection and close the window. Configure and test the button. If the button doesn't behave correctly, use the Delete button in the button configuration window to remove the button. Then, detect the button again and try binding it to a different rawcode. Rinse and repeat.
5.	I've configured my mouse. Nothing is happening.
	Make sure you have checked the Enabled check-box in btnx-config for every button that you want btnx to handle. Make sure you have restarted btnx after making any changes to the configuration file. Either press the Restart btnx in btnx-config or run the following command in your terminal: `$` sudo /etc/init.d/btnx restart It could be a problem with the btnx executable. First, stop btnx from command line and run it from the command line to see its output. Look for any errors. `$` sudo /etc/init.d/btnx stop `$` sudo btnx
6.	The same event happens multiple times when pressing a button.
	Try enabling the Force immediate button release setting in the General button properties group. This could also be a sensitivity problem with your mouse, or not. In any case, you should increase the delay value for that button in btnx-config (see Delay property). This will prevent the button from sending multiple events in a certain time frame. Also, make sure only one btnx process is running at a time.
7.	btnx doesn't work after upgrading.
	If you are upgrading from btnx-0.2.x, make sure you uninstall it first before installing the new version of btnx. Also, make sure you are not using the old (pre 0.3.0) configuration files. They no longer work.
8.	btnx doesn't work after plugging in a mouse of after standby.
	Make sure you have enabled hot-plugging in the Advanced settings (see Enable hot-plugging). It is possible that btnx will not start correctly after standby if you have the WAIT_FOR_SYSFS setting enabled.
9.	Booting hangs for a minute or two after installing btnx.
	Disable the WAIT_FOR_SYSFS setting. If you do not need hot-plugging, you can also disable that setting. (see Enable hot-plugging)

1.	A working `xorg.conf` `InputSection`.
	Most problems with btnx arise from different `xorg.conf` `InputSection` settings. You want xserver to handle as little from the mouse as possible, the most fundamental behavior aside. In essence, you want to downgrade your xserver functionality in connection to the mouse. This is sometimes necessary, because btnx cannot stop xserver from handling mouse button events if it wishes to do so. You will then get multiple events, often with xserver doing what you don't want. Most user's have found that changing the Driver, Protocol, and Device options to the reference values below has fixed their problems. Most importantly, make sure you are not using the evdev driver. Warning Laptop users should not edit their Synaptics touchpad settings. Warning Do not blindly copy the example below. Changing the `Identifier` in your `xorg.conf` might lead to an xserver startup failure. Warning Make sure you know how to edit the `xorg.conf` file. Make a backup of it before editing. You should know how to recover the backup file and restart from the command line in case you run into trouble. Below is a working `xorg.conf` `InputSection`. Try to make yours look like it as much as possible, but don't change the `Identifier value`. `Section "InputDevice" Identifier "Mouse0" Driver "mouse" Option "Protocol" "auto" Option "Device" "/dev/psaux" Option "ZAxisMapping" "4 5" EndSection` You may also try to use `/dev/input/mice` for the Device option. You can edit your `/etc/X11/xorg.conf` by running the following command: `$` sudo gedit /etc/X11/xorg.conf Save all your work and press Ctrl+Alt+Backspace to restart X. This will close your programs and your desktop!
2.	Running xev
	Install xev if you don't have it. Run xev by typing `$` xev Then, press the button which is giving you problems. For example, pressing the left mouse button outputs something like the following: `ButtonPress event, serial 29, synthetic NO, window 0x5000001, root 0x137, subw 0x0, time 1050685211, (163,11), root:(173,108), state 0x10, button 1, same_screen YES` Note the button number, `button 1`, reported by xev. The number will depend on the button you press. You can also use xev to check whether btnx is sending the correct keys when pressing a mouse button. In this case, look for a `keysym` value.
3.	xmodmap
	xmodmap can be used to change the behavior of a button in X. This is sometimes useful for buttons that are interpreted by xserver and sending an event. A common problem is that a button also sends a right click, opening up a menu. Use xev (see "Running xev") to find out what button number is being sent. Now, bind that button number to a higher one, one that is not handled by your window manager. Let's say a certain mouse button also sends a button number 6. The following shell command tells X to send a button 9 when it wants to send a button 6 event. `$` xmodmap -e "pointer = 1 2 3 4 5 9 7 8 6" Note, that 6 and 9 have changed places. If that doesn't work, try switching to another number, like 8 or 7. Now, add the line that worked for you in your ~/.Xmodmap file. Using the previous example, you would add the following: `pointer = 1 2 3 4 5 9 7 8 6` This will make the change persist on reboots.
4.	Installing lomoco
	lomoco is useful if your mouse wheel sends extra button events when scrolling. Another problem is mice with Cruise Control. Some buttons might give multiple events when pressing them. Here are tim71's instructions for installing and using lomoco. Install lomoco. If your system uses Debian packages and apt-get, you can probably get it by running `$` sudo apt-get install lomoco If your system doesn't have binary packages (deb or rpm) for lomoco, you can find the sources at http://lomoco.linux-gamers.net/. Run the following command to disable SmartScroll/Cruise Control: `$` sudo lomoco --no-sms Tell your system to start lomoco during boot with the `--no-sms`. You should consult your distro's sources of help on how to do this. However, the following should work for most users. Add this line into your `/etc/rc.local` immediately before the line "`exit 0`". `lomoco --no-sms`
5.	Check that the mouse is recognized as a USB input device.
	btnx might not work correctly if your mouse is not recognized as a USB input device. Make sure you aren't using a USB->PS/2 adapter with your mouse. You can check that the mouse is reported as a USB device with the following command: `$` cat /proc/bus/input/devices Now, find the section that refers to your mouse. The section should look something like this: `I: Bus=0003 Vendor=046d Product=c51a Version=0111 N: Name="Logitech USB Receiver" P: Phys=usb-0000:00:02.0-4/input0 S: Sysfs=/class/input/input182 H: Handlers=mouse2 ts2 event4 B: EV=7 B: KEY=ffff0000 0 0 0 0 0 0 0 0 B: REL=143` Check that the line starting with "`P: Phys=`" contains the word "`usb`". You can also check the output of that file to see if btnx registered correctly as an input device. Look for a section with `Vendor=b216`.

Troubleshooting

btnx specific problems

External programs and settings

Warning

Warning

Warning

Other sources of help