March 2, 2009
btnx might not work as intended on some distros anymore. If you want a highly configurable application for configuring your mouse, try easystroke. It was created for gesture-recognition but can also serve as a way to configure mouse buttons.
btnx: Button Extension- a GNU/GPL mouse tool for GNU/Linux
btnx is a daemon that enables rerouting of mouse button events through uinput as keyboard and other mouse button combinations. For example, you can configure an extra mouse button to send a Ctrl+Alt+Right command to switch workspaces. This is especially useful for mice with more buttons than Gnome or KDE can properly handle, or mice that need evdev and a 100 step howto to register button events at all. btnx integrates revoco, a program that allows changing MX Revolution's wheel behavior.
btnx-config is a GUI configuration tool for btnx. btnx requires btnx-config to work, because btnx-config also detects your mouse and its buttons. This combination should work for just about any mouse.
READ ME! If you are having trouble with extra mouse button events, make sure you check the manual's troubleshooting section that describes a working xorg.conf InputSection. This seems to be a problem especially with X.Org v7.3.
btnx-config screenshots in GNOME.
Latest versions (btnx *requires* btnx-config):
The subversion repositories for the project are located at:
These binary packages have been made by users. I have not tested them. If you make a package for your distro, you can submit it to me and I will add it to this list. There are also links to packages that are separately maintained for some distros.
btnx manual, also bundled with btnx-config. It contains installation and usage information. There is also a troubleshooting section which you should refer to if you have problems with btnx.
If you find this tool useful, please help others use it by translating it into another language: btnx-config @ Launchpad. Please notify me if you have completed the translations for a language, or if you made a correction to a completed translation. Languages fully translated and distributed:
Bug reports are valued. Please report them at Launchpad:
Old versions of btnx (pre v.0.3.0) do not require btnx-config. However, that branch is no longer maintained and the old btnx only works with supported mice. If you really want to use it, check this page: old btnx.
For any questions or comments, you can mail me directly at
oasalonen -a-t- gmail -d-t- com
You can also post your questions and comments in the
btnx thread
at the Ubuntu forums.
btnx version RSS feed.