Description =========== Fingerprint GUI is an application providing fingerprint-based authentication on Linux desktops. It features a simple GUI for fingerprint management and a PAM module. Fingerprint GUI is based on the libfprint library. Additionally, you may install the bundled non-free libbsapi library. In this case Fingerprint GUI will automatically support all fingerprint readers manufactured by UPEK, Inc. Supported hardware ================== For the list of fingerprint readers supported by libfprint see http://www.freedesktop.org/wiki/Software/fprint/libfprint/Supported_devices/. If you install the bundled libbsapi library, then all hardware by UPEK should be supported as well. Installation ============ 1. Generate the Makefile by running: $ qmake-qt4 or use the shell script "qmake.sh" 2. Build the software by running: $ make In order to compile the software you will need development packages for libfprint (version 0.1.0~pre2 and newer), libqt4, libqca2, libfakekey, libusb-1.0-0, libpolkit-qt-1 and libpam. 3. Copy all the files into their appropriate locations by running: # make install 4. If you want to add support for UPEK readers, install the bundled proprietary library by running: # make install-upek Please note that every user that wants to use this library must be member of group plugdev. This group is created automatically. 5. Since version 1.07 the ownership and permissions of users fingerprint data in "/var/lib/fingerprint-gui/" has been changed. Fingerprint-gui will not work with old ownership and permissions. To setup this data for version 1.07 change old fingerprint data (aquired with version 1.06 and below) by running: # make user-data 6. See the Step-by-step guide for instructions on how to modify your PAM stack to enable fingerprint-based authentication. Note on files destination: By default, everything gets installed under /usr/local. If you want to change the prefix to /usr, you can generate the Makefile (step 1) by running: $ qmake-qt4 PREFIX=/usr Additionally, libraries are installed into $PREFIX/$LIB, helper executables go into $PREFIX/$LIBEXEC, and the PAM module is installed into /$LIB/security. The default value for both $LIB and $LIBEXEC is "lib", which should be suitable for most Linux distributions. However, should you need to adjust the value of these two variables, you can set them in the same fashion as $PREFIX above. For instance, on 64-bit Fedora you would generate the Makefile with $ qmake-qt4 LIB=lib64 LIBEXEC=libexec or with $ qmake-qt4 PREFIX=/usr LIB=lib64 LIBEXEC=libexec provided you want to install into /usr. License ======= This software is released under GPL-2+. See COPYING for full text of the license. Copyright © 2008-2015 Wolfgang Ullrich <contact@ullrich-online.cc> Bugs ==== Bugs can be sent directly to the author or posted in the forums at http://home.ullrich-online.cc/fingerprint/Forum/ . Project home page ================= http://www.ullrich-online.cc/fingerprint/