You will need to compile both the program btnx and the program btnx-config.
This guide isn't necessarily for beginners but I will try to keep it simple.
UPDATE: I have found someone who is taking stewardship of the btnx project. He has moved the code from the derelict bazaar repos on Launchpad (one of which has permanently disappeared) and created a github repository for the project(s). He has also mainlined my patches and is tracking down other bugfixes on forks. I tested his code on Fedora 18, 19, Ubuntu 12.04, 13.04 and 13.10. All worked.
https://github.com/cdobrich/btnx
https://github.com/cdobrich/btnx-config
The instructions have been simplfied accordingly.
Compiling on Ubuntu
The compilation process for Ubuntu is almost exactly the same as for Fedora.(0) In general, you will need to be able to compile programs on your Ubuntu machine. You should have the package "build-essential" installed already.
(1) Grab the program source files.
For the btnx-config page, you want to download
https://github.com/cdobrich/btnx-config
For the btnx page, you want to download
https://github.com/cdobrich/btnx
(2) Open up your favorite terminal. To install the btnx dependencies, do the following:
sudo apt-get install libdaemon-dev libgtk2.0-dev libglade2-dev(3) Navigate there and run './configure' (without quotes), and then 'make' (without quotes) and finally 'make install' (without quotes).
(4) Now both programs of btnx and btnx-config are installed on your system.
Compiling on Fedora
The compilation process for Fedora is almost exactly the same as for Ubuntu.(0) In general, you will need to be able to compile programs on your Ubuntu machine. You should have the packages to compile and build programs installed already. To this in Fedora, run the following command:
sudo yum groupinstall "Development Tools" "Development Libraries"This might be a bit overkill since it installs a lot, and you can remove this group when you are done.
(1) Grab the program source files.
For the btnx-config page, you want to download
https://github.com/cdobrich/btnx-config
For the btnx page, you want to download
https://github.com/cdobrich/btnx
(2) Open up your favorite terminal. To install the btnx dependencies, do the following:
sudo yum install libdaemon-devel gtk2-devel libglade2-devel(3) Navigate there and run './configure' (without quotes), and then 'make' (without quotes) and finally 'make install' (without quotes).
(4) Now both programs of btnx and btnx-config are installed on your system.
Errors
Error message:failed to execute command /etc/init.d/btnx restartCause: You probably don't have the little dongle for the USB mouse plugged in. At least I always get this error if I try to use the btnx-config program and don't have my mouse plugged in yet.
Warning
It may appear in your applications-menus, but I have noticed a problem with using inside KDE. It asks for the ROOT password, not my user password with elevated privileges. I'm not sure how to fix this, but I'd love to find out. It's not a big deal for me though.Hope that helps anyone.