Build and installation instructions

Dependencies

In order to build synaptiks, the following libraries and their development files must be available:

• Qt 4.6 or newer
• KDE Libraries and KDE base runtime 4.4 or newer (earlier releases might work, too, but are untested)
• libXi 1.2 or newer (1.3 or newer for XInput2 support)

Additionally xf86-input-synaptics 1.2 or newer must be loaded, while synaptiks is running. xf86-input-synaptics 1.0 and 1.1 might work, but are untested. xf86-input-synaptics 0.x is not supported.

Getting synaptiks

Normally you’ll want to use the stable release. Download it, extract the archive and change into the directory:

$ wget http://bitbucket.org/lunar/synaptiks/downloads/synaptiks-0.4.0.tar.bz2
$ tar xjf synaptiks-0.4.0.tar.bz2
$ cd synaptiks-0.4.0

Alternatively, you can install subversion and retrieve the latest development snapshot straight from the repository:

$ svn co svn://anonsvn.kde.org/home/kde/trunk/playground/utils/synaptiks
$ cd synaptiks

However, the development snapshot may be unstable and could be broken. You have been warned.

Configuring, building and installating synaptiks

Create a build directory and change into it. A separate build directory is used to keep the source tree clean from build files:

$ mkdir build
$ cd build

Now make sure, that all dependencies (see above) are installed. Now configure the synaptiks:

$ cmake -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix) ..

If you have libXi 1.3 or newer installed (see above), enable XInput2 support:

$ cmake -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix) -DHAVE_XINPUT2=ON ..

XInput2 is not required for synaptiks to function properly. However, XInput support is deprecated and will sooner or later be removed from synaptiks.

After configuration has successfully finished, build and install synaptiks:

$ make
$ sudo make install

The build configuration is cached in the build directory. It can be edited with ccmake or cmake-gui. Refer to the cmake documentation for detailed information about cmake.