Ferrite

Status
Active
Domain
Hardware
Stack
RustTokio
Role
Creator
Year
2026

Rust crates and a CLI for ZKTeco biometric and access-control devices, with feature parity with pyzk. Published on crates.io.


Problem

ZKTeco attendance and door controllers sit in thousands of offices, and most software that talks to them is a Python library from another era. I wanted a client that is typed, async, and easy to embed in a service or run from a shell.

Architecture

Three crates, split so the protocol can be tested without a device or a network:

  • zkteco-proto is a sans-IO implementation of the protocol: packets, checksums, the comm key, record layouts, and time encoding.
  • zkteco-client is an async Tokio client over TCP and UDP for device data, live events, and enrolment.
  • zkctl is the command-line tool: device info, users, attendance export, live event streaming, and diagnostics.