Quick Start Guide¶

This guide will help you get started with the id3 Finger SDK in just a few simple steps.

Step 1: Request a License¶

To use the SDK, you’ll need a valid license. Here’s how to get started:

Create an account on our customer portal: https://customer.id3.eu
Contact our sales team at contact@id3.eu to request a license
You’ll receive a license key and download instructions

Step 2: Download the SDK archive¶

Download the SDK archive from the link provided by our sales team
Extract the archive to your preferred location

The SDK is delivered as a compressed archive containing the following structure:

├───activation/               # License activation tools
│   ├───cli-tool/            # Command-line activation
│   └───windows-tool/        # Windows GUI activation
├───bin/                      # Native libraries and tools
│   ├───android/             # Android binaries
│   ├───apple/               # iOS/macOS binaries
│   ├───linux/               # Linux binaries
│   └───windows/             # Windows binaries
├───dart/                    # Flutter/Dart wrapper
│   └───id3_finger/
├───devices/                 # Device-specific libraries
├───docs/                     # Documentation
│   ├───3rdparty/
│   ├───javadoc/
│   └───developer-guide/
├───dotnet/                  # .NET assemblies
├───include/                  # C/C++ headers
├───java/                     # Java archives
├───python/                   # Python package
├── CHANGELOG.md             # Release notes
├── LICENSE.md               # License information
└── README.md                # Basic documentation

Step 3: Download AI Models¶

The SDK requires AI models for operation. Follow these steps to get started:

Download the required models from: https://cloud.id3.eu/index.php/s/92j6TxJErRPnGL9
Extract the models to a known location (e.g., ~/finger_models/)

Note

Only download the models you need for your specific use case. See AI Models for details on available models and their purposes.

Step 4: Install the SDK¶

Python

pip install id3finger

Or select the suitable wheel file for your platform and Python version, and run

pip install id3finger-x.y.z-cp311-cp311-win_amd64.whl

Then import it in your code:

import id3finger
print(f"Using Finger SDK version: {id3finger.__version__}")

Dart

Add the dependency to your pubspec.yaml:

dependencies:
  id3_finger:
    path: ../../sdk/dart/id3_finger

Then import it in your Dart code:

import 'package:id3_finger/id3_finger.dart';

Include the namespace:

using id3.Finger;

Java

Add the Maven dependency to your pom.xml:

<dependency>
    <groupId>eu.id3</groupId>
    <artifactId>finger</artifactId>
    <version>1.0.0</version> <!-- Use the latest version -->
</dependency>

Then import the package:

import eu.id3.finger.*;

Include the header file in your project:

#include "id3Finger.h"

// Link against the appropriate library for your platform
// - Windows: id3Finger.lib
// - Linux: -lid3finger

Step 5: Run the Samples¶

Explore our sample projects to see the SDK in action. The samples are available for multiple platforms:

C/C++: Windows, Linux
.NET: C# examples
Mobile: Android (Kotlin/Java) and iOS (Swift)
Cross-platform: Flutter (Dart)
Python: Quick integration examples

# Clone the samples repository
git clone https://github.com/id3Technologies/finger-sdk-samples.git
cd finger-sdk-samples

Note

For detailed setup instructions for each platform, refer to the README in each sample directory.

Step 6: Add the SDK to your own project¶

Windows

The SDK relies on native libraries that must be copied to a bin subdirectory within your project’s target directory.

The following libraries are necessary:

Library	Description
`id3Finger.dll`	The main library for fingerprint processing and operations.
`id3FingerCapture.dll`	Facilitates the capture of fingerprint images from devices.
`id3Devices.dll`	Handles communication with capture devices.

To automate the process within Visual Studio, add a pre-build event to your project:

Right-click on your project in the Solution Explorer and select Properties.
Go to the Build Events tab.

In the Pre-build event command line box, enter the following command:

mkdir $(TargetDir)bin
mkdir $(TargetDir)devices

xcopy /e /y $(SolutionDir)..\..\bin\*.dll $(TargetDir)\bin
xcopy /e /y $(SolutionDir)..\..\devices\* $(TargetDir)\devices

This command copies all DLL files from the SDK’s native library directory to the bin subdirectory of your project’s target directory every time the project is built.

Ensure the path $(SolutionDir)..\..\ is correctly adjusted to point to the location where the SDK’s native libraries are stored.

Linux

Add one of the following native library:

/bin/linux/x64/libid3Finger.so, or
/bin/linux/x64_gpu/libid3Finger.so for CUDA support.

Android

Include the AAR package to your project:

/bin/android/eu.id3.finger.aar

Apple

Include the package in your project:

Unzip the Framework:
Unzip the /bin/apple/id3Finger.xcframework.zip package to access the id3Finger.xcframework directory.
Add the Framework to Xcode:
Open your Xcode project and drag the id3Finger.xcframework directory into the “Frameworks, Libraries, and Embedded Content” section.
Update Build Settings:
Ensure that id3Finger.xcframework is listed under “Link Binary with Libraries” in your target’s “Build Phases”. Set the “Framework Search Paths” in your target’s “Build Settings” to include the path to id3Finger.xcframework.
Configure Code Signing:
Adjust the code signing settings in Xcode to allow the app to run with the included framework.
Handle Runtime Dependencies:
Ensure any additional runtime dependencies required by id3Finger.xcframework are included.