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.
Actually btnx integrates revoco, a program that allows changing MX
Revolution’s wheel behavior, but in the Debian version the revoco
functionality has been removed because it doesn’t have a clean license.
btnx is best configured by using btnx-config, which is needed anyway.
btnx requires btnx-config to work, because btnx-config also detects
your mouse and its buttons. This combination should work for just about
You need to run btnx-config and use it to configure btnx at least once,
before the btnx-daemon can successfully start.
btnx was written by Olli Salonen <email@example.com>.
This manual page was created by Philipp Huebner <firstname.lastname@example.org>
for the Debian project (but may be used by others).