Results 1 to 10 of 1273

Thread: btnx: Send keyboard and mouse combination events with mouse buttons

Threaded View

  1. #1
    Join Date
    Jun 2006
    Ubuntu Jaunty Jackalope (testing)

    btnx: Send keyboard and mouse combination events with mouse buttons

    If you find this tool useful, please help others use it by translating it into another language: btnx-config @ Launchpad.

    Latest versions:

    btnx (Button Extension) 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. You can also configure buttons to execute commands. 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-config is GUI for detecting and configuring your mouse. You must use btnx-config with btnx. btnx integrates revoco functionality for MX Revolution users, which is editable from btnx-config.

    btnx should work with almost any mouse that is configured properly.

    The btnx manual is available at:
    btnx is known to work on:
    • (K)Ubuntu 7.04
    • (K)Ubuntu 7.10
    • (K)Ubuntu 8.04

    Note: Users with an MX or VX Revolution: if you have problems with the thumb buttons, refer to the btnx manual's troubleshooting section 12.2.1 for better xorg.conf values.

    Report bugs at Launchpad:

    SVN repositories :



    You have two options. Either install (1) binary packages with apt-get or (2) compile from source.

    Note: If you have used another howto to configure your mouse, try to revert as much of the changes you have done.

    1. Binary packages:

    Note: KDE (Kubuntu) users should compile from source if you want to avoid installing lots of standard Gnome libraries.

    1. Put the following lines to the end of your /etc/apt/sources.list file, but replace DISTRO with the name of the Ubuntu distro you have installed (options: feisty gutsy hardy):

    deb DISTRO main
    deb-src DISTRO main

    2. Now, run the following commands to install btnx and btnx-config:

    $ sudo apt-get update && sudo apt-get install btnx
    3. Run btnx-config from Applications->System tools->btnx and refer to the manual as necessary.

    2. (Optional) Compile from source

    1. Get all the necessary dependencies. btnx-config needs libgtk2.0 and libgtk2.0-dev (version 2.10.11 or newer), libglade and libglade-dev (version 2.6.0 or newer), pkg-config (0.21 or newer), and build-essential. btnx needs build-essential and libdaemon.
    sudo apt-get install build-essential libgtk2.0-0 libgtk2.0-dev libglade2-0 libglade2-dev pkg-config libdaemon0 libdaemon-dev
    2. Install btnx
    $ wget
    $ tar -xvvf btnx-0.4.11.tar.gz
    $ cd btnx-0.4.11
    $ ./configure
    $ make
    $ sudo make install
    3. Install btnx-config.
    $ wget
    $ tar -xvvf btnx-config-0.4.9.tar.gz
    $ cd btnx-config-0.4.9
    $ ./configure
    $ make
    $ sudo make install
    If you encountered an error, there is probably a dependency problem.

    4. You should have gotten a menu item. In GNOME, Applications->System tools->btnx. In KDE, System->btnx. Press it to launch btnx-config.

    You can find all the necessary information for configuring your mouse with btnx-config in the btnx manual. Either press the "Help" button in btnx-config or refer to the online manual at



    Binary packages:

    $sudo apt-get remove btnx btnx-config

    Compiled source:

    To uninstall btnx and btnx-config, run
    $ sudo make uninstall
    in the same directory as where you ran the "sudo make install" command for both programs.



    Please refer to the troubleshooting section in the btnx manual:

    It contains answers to frequent problems and good reference values for your xorg.conf file.

    NOTE: If some of your mouse buttons send multiple events (like extra middle, right, or left clicks) then refer to the
    manual's troubleshooting section on editing you xorg.conf InputSection. Follow it closely!

    If your problem persists, post it on this thread.


    Useful key combos

    blazoner posted a list of some useful keyboard combinations to use with btnx. Look here.


    If you feel that btnx or extra mouse button control is an important issue, don't forget to let your vote and voice be heard over at Brainstorm:

    Last edited by daou; May 2nd, 2008 at 11:53 AM.
    echo -e "\x6f\x61\x73\x61\x6c\x6f\x6e\x65\x6e\x40\x67 \b\x6d\x61\x69\x6c\x2e\x63\x6f\x6d"
    It compiles! Ship it!


Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts