zkteco-js

KO | EN

gitlite — search

#python #ai #typescript #linux #docker #macos #nodejs #java #cli #kubernetes #pytorch #openai #mcp #open-source

(★ 23)

The zkteco-js library allows Node.js developers to easily interface with ZK BioMetric Fingerprint Attendance Devices, extract and manage data, and integrate biometric features into attendance systems efficiently. Resources

zkteco-js Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Warning

**⚠️ This repository is not recommended for use in production. ⚠️**

This repository is currently in development and may contain bugs or incomplete features. Use at your own risk and do not deploy to a production environment.

# About zkteco-js
The zkteco-js library provides a robust solution for Node.js developers to interface with ZK BioMetric Fingerprint Attendance Devices. Its user-friendly API allows seamless extraction of data, such as registered users, logs, and device versions. Developers can also add users, retrieve real-time logs, and clear attendance records. Using a socket connection, the library ensures fast and reliable data exchange. Whether creating an attendance system or a time-and-attendance management application, zkteco-js is the essential tool for integrating biometric devices efficiently.

### Installation

```bash
npm i zkteco-js
```

Or, if you prefer Yarn:

```bash
yarn add zkteco-js
```

### Usage Example

```js
const Zkteco = require("zkteco-js");

const manageZktecoDevice = async () => {
    const device = new Zkteco("192.168.1.106", 4370, 5200, 5000);

try {
        // Create socket connection to the device
        await device.createSocket();

// Retrieve and log all attendance records
        const attendanceLogs = await device.getAttendances();
        console.log(attendanceLogs);

// Listen for real-time logs
        await device.getRealTimeLogs((realTimeLog) => {
            console.log(realTimeLog);
        });

// Manually disconnect after using real-time logs
        await device.disconnect();
    } catch (error) {
        console.error("Error:", error);
    }
};

manageZktecoDevice();
```

### API Reference :

- `createSocket()` - Establishes a connection to the device.
- `getInfo()` - Provides general information about the device, including log capacity and user count.
- `getUsers()` - Retrieves an array of all users stored on the device.
- `setUser(uid, userid, name, password, role = 0, cardno = 0)` - Adds a new user to the device.
- 🆕 `deleteUser(uid)` - Delete an user from the device.
- `getAttendances()` - Retrieves an array of all attendance logs from the device.
- `getRealTimeLogs(callback)` - Sets up a real-time log stream and calls the provided callback function with each new log entry.
- `getPIN()` - Retrieves the device PIN.
- `getTime()` - Retrieves the current time from the device.
- 🆕 `setTime(DateTime)` - Updates the device's time.
- `getFaceOn()` - Checks if the device's Face On feature is enabled.
- `getSSR()` - Retrieves the device's Self-Service Recorder (SSR) status.
- `getDeviceVersion()` - Retrieves the device's firmware version.
- `getDeviceName()` - Retrieves the device's name.
- `getPlatform()` - Retrieves the device's platform version.
- `getOS()` - Retrieves the device's operating system version.
- `getAttendanceSize()` - Retrieves the total number of attendance records stored on the device.
- `clearAttendanceLog()` - Clears all attendance logs from the device.
- `disconnect()` - Disconnects the device from the network.
- 🆕 `clearData()` - Clear All Data from the device (all users,attendances logs etc ).
- 🆕 `voiceTest()` - Voice Test.
- 🆕 `getVendor()` - get vendor name.
- 🆕 `getProductTime()` - get product created time.
- 🆕 `getMacAddress()` - get device MAC address.

## Contributing

Please see [CONTRIBUTING](https://github.com/coding-libs/zkteco-js/graphs/contributors) for details.
## Security

If you've found a bug regarding security please mail [codinglibs4u@gmail.com](mailto:codinglibs4u@gmail.com) instead of using the issue tracker.

## Alternatives

- [adrobinoga/zk-protocol](https://github.com/adrobinoga/zk-protocol)
- [dnaextrim/python_zklib](https://github.com/dnaextrim/python_zklib)
- [caobo171/node-zklib](https://github.com/caobo171/node-zklib)

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

zkteco-js

zkteco-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

zkteco-js

zkteco-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README