Once you have the SDK integrated, consider contributing to the community. Create a public GitHub repository containing:
Bad Repository Example: Uploading FingerspotSDK.dll directly (copyright violation).
Good Repository Example: A install-sdk.sh script that downloads the SDK from a secured URL after the user enters their credentials.
In the world of biometric access control and workforce management, Fingerspot is a well-known brand, particularly in Southeast Asia. Their devices (fingerprint scanners, RFID readers, and facial recognition terminals) are widely used for attendance tracking and secure access.
For developers looking to integrate Fingerspot devices into custom applications (e.g., HR systems, ERP software, or IoT platforms), the Fingerspot SDK (Software Development Kit) is essential. A common question arises: Where is the Fingerspot SDK on GitHub?
This piece clarifies what is officially available, what community resources exist, and how to approach development with Fingerspot hardware.
The short answer: Fingerspot (manufactured by PT. Cihampelas Teknologi) does not always publish their SDK directly on a public, searchable GitHub organization like github.com/fingerspot. In many cases, the SDK is distributed via:
However, third-party developers and system integrators have uploaded wrappers, libraries, and reverse-engineered APIs to GitHub. When searching for "fingerspot sdk github", you will likely find two types of repositories:
Build your own bridge using TCP/UDP sniffing. Some GitHub projects capture packets between the Fingerspot software and device, then forward to MQTT for IoT integration.
Sometimes, a Fingerspot distributor will upload the official SDK_Manual_v2.1.zip or demo applications to a GitHub release page to avoid emailing large files.
If you cannot obtain the official SDK, consider these open-source paths:
Fingerspot SDK content on GitHub primarily focuses on the EasyLink SDK
, which allows developers to integrate biometric attendance devices with web or desktop applications. While Fingerspot provides official software, the GitHub ecosystem is largely composed of community-driven wrappers and libraries designed to bridge the SDK with modern programming languages. Key GitHub Repositories for Fingerspot SDK easylink-js
: A JavaScript library designed for communicating with the Fingerspot EasyLink SDK. It simplifies tasks like initializing devices, syncing date/time, and managing user data via a simple class interface. fingerplus
: A repository specifically dedicated to the Fingerspot EasyLink SDK implementation, often used as a reference for integrating Fingerplus hardware. fingerspot-easylink-ts
: A TypeScript-based library for device operations, including template management and scan log retrieval. Php-Fingerprint-flexcode-sdk
: A PHP implementation for those using the FlexCode SDK variant, featuring scripts for user registration and verification. Core Functionality Supported
Through these libraries, developers can perform the following operations: Device Management
: Retrieve device information, set device time, and restart devices remotely. User & Template Management
: Upload new users, delete users, and manage biometric fingerprint templates. Data Retrieval
: Fetch all scan logs (attendance records) or only new records since the last sync. Web Integration
: Bridges local hardware (often running on a local host port like 7005) with cloud-based or local web applications. Implementation Example (JavaScript) easylink-js library, a typical integration looks like this: javascript easyLink = EasyLink({ host: 'http://localhost:7005' , serialNumber: 'YOUR_DEVICE_SN' // Example: Get basic device info deviceInfo = easyLink.getDeviceInfo(); // Example: Sync time with the server easyLink.syncDateTime(); Use code with caution. Copied to clipboard Important Considerations Hardware Compatibility : Most GitHub SDK wrappers are built for the
series. Ensure your Fingerspot device model supports these protocols. Local Service Requirement
: Many of these libraries require the official Fingerspot EasyLink service to be running locally on the machine connected to the hardware. Platform Limits
: Some SDK variants, such as those for FlexCode, may have specific requirements for Windows environments or browser-side capturing. code walkthrough for one of these languages or help finding a library for a different model
dewadg/easylink-js: Library for communicating with ... - GitHub fingerspot sdk github
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation.
dewadg/easylink-js: Library for communicating with ... - GitHub
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation.
dewadg/easylink-js: Library for communicating with ... - GitHub
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation.
ariefrahmansyah/fingerplus: Fingerspot EasyLink SDK · GitHub
Overview The FingerSpot SDK is an open-source library for fingerprint recognition and authentication. It provides a simple and efficient way to integrate fingerprint scanning capabilities into various applications.
Key Features
Pros
Cons
Code Quality
Community
Conclusion The FingerSpot SDK is a useful open-source library for fingerprint recognition and authentication. While it has some limitations, such as limited documentation and no official support, it provides a simple and efficient way to integrate fingerprint scanning capabilities into various applications. With some improvements in documentation, testing, and community engagement, the FingerSpot SDK can become a more robust and widely adopted solution.
Rating: 4/5
Recommendations
To integrate Fingerspot devices via GitHub-hosted SDKs, you primarily work with the EasyLink SDK or FlexCode SDK protocols. These allow communication between biometric devices and web or desktop applications. 🚀 Top SDK Repositories
The most active community-maintained SDKs for Fingerspot on GitHub include:
easylink-js: A JavaScript/Node.js library for the EasyLink SDK.
fingerspot-easylink-ts: A TypeScript implementation for multi-device management.
Php-Fingerprint-flexcode-sdk: A PHP implementation focused on the FlexCode protocol.
fingerplus: A community wrapper for Fingerspot EasyLink SDK. 🛠️ Implementation Guide (EasyLink SDK)
The EasyLink SDK is the modern standard for Fingerspot's Revo and Neo series. It typically uses an intermediary service (local server) to bridge the hardware and your app. 1. Installation For JavaScript-based environments, use easylink-js: npm install easylink-js # OR yarn add easylink-js Use code with caution. Copied to clipboard 2. Basic Setup
Initialize the connection using the device's IP address or the local host where the service is running. javascript
const EasyLink = require('easylink-js'); const easyLink = new EasyLink( host: 'http://localhost:7005', // Default EasyLink port serialNumber: 'YOUR_DEVICE_SN' ); Use code with caution. Copied to clipboard 3. Key Functions Get Device Info: await easyLink.getDeviceInfo(); Sync Time: await easyLink.syncDateTime(); Fetch Logs: await easyLink.getNewScanLogs(); Once you have the SDK integrated, consider contributing
User Management: Use uploadUser() to register templates remotely. 💻 FlexCode SDK (PHP)
If you are using older devices or specific web-based registration, the FlexCode SDK is often used.
Requirements: Requires the FlexCodeSDK.exe to be running as Administrator on the client machine. Process: User clicks "Register" on your web app.
Browser calls a custom protocol (e.g., finspot:FingerspotReg).
The local SDK app opens, captures the print, and sends the template back to your server. ⚠️ Important Considerations
Firewall: Ensure port 7005 (EasyLink) or your custom ports are open.
Architecture: For cloud-based apps, you often need a "Bridge" computer on-site to communicate with local IP devices.
Official Documentation: For deep technical specs, refer to the Fingerspot Developer Portal.
💡 Key Point: Always run local SDK executable files as Administrator to avoid communication timeouts.
dewadg/easylink-js: Library for communicating with ... - GitHub
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation.
ariefrahmansyah/fingerplus: Fingerspot EasyLink SDK · GitHub
Use saved searches to filter your results more quickly * Code. * Issues. * Actions. * Security.
dewadg/easylink-js: Library for communicating with ... - GitHub
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation. Anemo27/fingerspot-easylink-ts - GitHub
Based on the available repositories for the Fingerspot SDK on GitHub, there are several community-driven libraries designed to integrate Fingerspot attendance devices with modern software stacks. Most of these focus on the EasyLink SDK
, which allows communication with biometric devices via a server. Available SDK Implementations easylink-js
: A JavaScript library built for communicating with the Fingerspot EasyLink SDK. It simplifies the process of sending commands to the device from a web environment using npm or yarn. fingerspot-easylink-ts
: A TypeScript-based SDK that supports managing multiple devices simultaneously. It provides typed interfaces for DeviceConfig DeviceResponse
, making it ideal for enterprise-level applications where data structure is critical. fingerplus
: Another public repository dedicated to the Fingerspot EasyLink SDK implementation. Common Integration Steps
dewadg/easylink-js: Library for communicating with ... - GitHub
Several open-source projects on GitHub provide SDKs and integration tools for Fingerspot hardware, primarily focusing on its EasyLink SDK. Key GitHub SDKs and Libraries
easylink-js: A JavaScript library designed for communication with the Fingerspot EasyLink SDK. It supports methods for getting device information, initializing devices, synchronizing date/time, and managing user and scan logs. Bad Repository Example: Uploading FingerspotSDK
fingerspot-easylink-ts: A TypeScript implementation for EasyLink that handles device operations like log management, user management, and template management.
go-fingerspot: A Go package for interacting with Fingerspot services, including functions to get user info and attendance logs (GetAttLog).
fingerplus: A repository specifically labeled for use with the Fingerspot EasyLink SDK. Reporting and Management Tools
PTUN-Report-Tool: A JavaFX client application specifically built for generating reports from Fingerspot machines using the EasyLink SDK.
Web-Sistem-Monitoring-Absensi-Pegawai-Fingerspot: A web-based employee attendance monitoring system built with PHP (CodeIgniter) to manage Fingerspot data.
fingerprint-solution: A library for downloading attendance data from Fingerprint/Solution machines via IP. General Support
For official Fingerspot developer resources, users often rely on local Indonesian support forums or direct documentation from the Fingerspot website, as many GitHub repos are community-driven wrappers for their proprietary SDKs.
Do you need help with a specific programming language for your Fingerspot integration?
dewadg/easylink-js: Library for communicating with ... - GitHub
Open-source developers have created wrappers to simplify communication with Fingerspot's proprietary EasyLink SDK. TypeScript/JavaScript Implementation:
fingerspot-easylink-ts: A library for multi-device management. It allows developers to get users, manage device configurations, and handle multiple IP/Port connections simultaneously.
easylink-js: A simpler JavaScript library that provides essential methods like getDeviceInfo(), syncDateTime(), getAllUsers(), and getNewScanLogs(). Go Implementation:
go-fingerspot: A package for Go (Golang) that includes functions for calling device URLs, retrieving attendance logs (GetAttLog), and managing user information (SetUserInfo, DeleteUserInfo). Web-Based Monitoring:
Web-Sistem-Monitoring-Absensi-Pegawai-Fingerspot: A repository demonstrating how to integrate the SDK into a PHP-based web system for employee attendance monitoring. Technical Capabilities of the SDK Based on these repositories, the SDK primarily supports:
Biometric Data Management: Uploading and deleting user templates (fingerprint data), names, and PINs.
Attendance Logging: Fetching real-time or historical scan logs from the device.
Device Control: Synchronizing date and time, checking device status, and clearing logs. How to Use the SDK (General Workflow)
Installation: Most JS-based wrappers can be installed via npm i easylink-js or npm i fingerspot-easylink.
Initialization: Requires the device's Server IP, Port, and Serial Number.
Authentication: Often uses a token or predefined credentials depending on the implementation.
If you are looking for an academic paper on biometric integration or the underlying algorithm, you might need to search for broader topics like "Biometric attendance system integration via SDK" or "ZKTeco/Fingerspot communication protocols" (as Fingerspot devices often share protocols with ZKTeco).
dewadg/easylink-js: Library for communicating with ... - GitHub
Repository files navigation. README. easylink-js. JavaScript library for communicating with Fingerspot EasyLink SDK. Installation. Anemo27/fingerspot-easylink-ts - GitHub
JavaScript. const FingerspotEasyLink = require('fingerspot-easylink'); const sdk = new FingerspotEasyLink({ devices: [ npT2md" data-wiz-attrbind="class=Hj9ylc_1j/R4Tih" jscontroller="udAs2b" data-sfc-root='c' data-wiz-uids="Hj9ylc_1k,Hj9ylc_1l" data-sfc-cb=""> 🛠️ Core Features