Page tree
Skip to end of metadata
Go to start of metadata

This is a desktop client that encompasses the fingerprinting capability. It is based on a javaFX frame work with the all scanner classes packed into an executable jar file.

We have targeted windows operating system in this particular update (preferably windows 10).


  • A working URL instance of the previously set OpenMRS server with biometrics module installed

  • Verifinger DLLs (NBiometricClient.dll, NBiometrics.dll, NCore.dll, NDevices.dll, NdmMedia.dll, Neurotec.dll, NLicensing.dll, NMedia.dll, NMediaProc.dll)

  • Scanner DLLs (depending on the scanner being used e.g NdmDigitalPersonaUareU.dll for Digital Persona UareU, NdmFutronic.dll for Futronic)

  • A working fingerprint Scanner (Digital Persona UareU or Futronic) with scanner drivers installed (Preferably futronic FS80).

  • A working instance of GIT

  • A working instance of MAVEN

  • Java development kit( 8+)

We have tested with two device models:

  • Futronic FS80

  • Digital Persona URU4500

Both devices work well to support scanning but Futronic FS80 performs better when compared to Digital Persona URU4500.

NB: Scanner DLLs and Verifinger DLLs should be copied into java bin folder


1. Compiling/packaging Neurotec jar files to .m2 directory

  • Download verifinger trial SDK and extract the zip file
  • Run the following command inside the root folder of SDK

    mvn clean install

  • Change directory to samples folder inside the SDK main directory and run

    cd samples


    mvn clean install

  • Change directory to Biomterics/Java folder inside samples folder

    cd Biometrics/java

    then run

    mvn clean install

2. Compiling Biometrics Client

NB: Before compiling biometrics-client please ensure you have a jfxrt.jar file in java bin directory.

  • Change directory to biometrics-client using

    cd biometrics-client

  • Maven Compile using

    mvn clean package

    The above command will create an executable jar file inside target folder named mUzima-scanner.

    NB: It is recommended to create a .bat file and copy the following content to it.

    echo off

    start javaw jar %~dp0muzima-scanner.jar%*


The .bat and .jar files should be placed in the same location, then you can place a shortcut to .bat file on the desktop or anywhere easily accessible.

Launching Biometrics Client

Launching of the biometrics-client will be by double clicking the .bat file or .bat shortcut link.

  • No labels