btnx Manual
PrevNext

3. Installing from sources

This section describes how to install and uninstall btnx and btnx-config from the source packages. Some binary packages are available on the btnx website. btnx has also been included in some distros' repositories, including Arch Linux.

3.1. Installing btnx

  1. Make sure you have uinput compiled into the kernel or available as a module. You can test if uinput is available as a module with the command (as root): 

    
# modprobe uinput

  2. Get all the necessary dependencies. btnx v.0.4.8 depends on libdaemon >= 0.10. Ubuntu and Debian users can use the following command: 

    
$ sudo apt-get install libdaemon0 libdaemon-dev

  3. Get the newest btnx from http://www.ollisalonen.com/btnx.

  4. Extract the source package.

  5. Run the following commands in the source top directory to build and install btnx (run "make install" as root):

    
$ ./configure
$ make
# make install

You can give the following parameters to the btnx configure script:

init_scripts_path=/path/to

Set to the path of your system's init script directory. Default is /etc/init.d. Do not append a '/' to the path!

config_path=/path/to

Set to the path of the directory where btnx configuration files are stored. Default is /etc/btnx. Do not append a '/' to the path!

init_tool=no

Install the btnx daemon init script, but do not run any tools to register it. This is useful for package maintainers of certain distros. Default is "yes", which means the configure script autodetects update-rc.d, chkconfig, or rc-update and uses it to register the init script during installation.

output_syslog=yes

Configure the init script to launch btnx with output directed to syslog. Use this if you want a relatively quiet btnx startup. It is equivalent to calling btnx -l from the command line. Default is "no".

btnx should now be installed but isn't running because it doesn't have a configuration file. You need btnx-config for this.

3.2. Installing btnx-config

  1. Get all the necessary dependencies. If your distro has apt-get and fresh enough packages for the dependencies, you can use the following command (ie. Ubuntu >= 7.04 users): 

    
$ sudo apt-get install build-essential libgtk2.0-0 libgtk2.0-dev libglade2-0 libglade2-dev pkg-config
    Omit or replace build-essential if your distro packages gcc and its friends in another way. Here are the dependencies and their versions:

    1. libglade >= 2.6.0 (ftp download)

    2. libgtk2.0 >= 2.10.11 (download page)

    3. pkg-config >= 0.21 (download page)

    You can now check that all dependencies are satisfied with pkg-config 
    
$ pkg-config --modversion gtk+-2.0
$ pkg-config --modversion libglade-2.0
$ pkg-config --version

  2. Get the newest btnx-config from http://www.ollisalonen.com/btnx.

  3. Extract the source package.

  4. Run the following commands in the source top directory to build and install btnx-config:

    
$ ./configure
$ make
# make install

You can give certain parameters to the btnx-config configure script:

init_scripts_path=/path/to

Set to the path of your system's init script directory. Default is /etc/init.d. Do not append a '/' to the path!

udev_rules_path=/path/to

Set to the path of your system's udev rules.d directory. Default is /etc/udev/rules.d. Do not append a '/' to the path!

builddocs=no

Do not install this manual with btnx-config.

--disable-nls

Disable internationalization support for btnx-config.

--prefix=path

btnx-installation prefix. The default is recommended.

3.3. Upgrading

If you are upgrading from btnx or btnx-config older than 0.4.7, you do not need to uninstall. However, these versions use incompatible configuration files. You will need to redetect and reconfigure your mouse.

If you are upgrading from btnx-0.2.x or btnx-config-0.1.x, make sure to uninstall them first. The file structures have changed since then and you might be left with orphaned files on your system, or an nonworking installation.

Also, if you used the install-generic target for btnx-0.2.x, you no longer need to use it. In fact, no such target exists anymore.

3.4. Uninstallation

To uninstall either btnx or btnx-config, run the following command in the extracted source package directory as root: 


# make uninstall
Uninstalling btnx-config will not affect your btnx configuration.

PrevHomeNext
Steps to get btnx working Running btnx-config