RustZK

A pure Rust implementation of the ZK attendance device protocol.

📦 Installation

Add rustzk to your Cargo.toml.

From Crates.io

[dependencies]
rustzk = "0.2.1"

From GitHub

[dependencies]
rustzk = { git = "https://github.com/vkaylee/rustzk" }

🚀 Usage Example

use rustzk::{ZK, ZKProtocol};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut zk = ZK::new("192.168.1.201", 4370);
    
    // Set password if device requires authentication (default is 0)
    zk.set_password(0);
    
    // Connect to device (Auto-detect protocol: TCP then UDP fallback)
    zk.connect(ZKProtocol::Auto)?;
    
    // Get user list (Handles GBK decoding automatically)
    let users = zk.get_users()?;
    println!("Found {} users", users.len());
    
    // Get attendance logs
    let logs = zk.get_attendance()?;
    println!("Found {} attendance records", logs.len());

    // Disconnect
    zk.disconnect()?;
    
    Ok(())
}

📜 License

MIT

🙏 Acknowledgements

This project is a Rust port of the pyzk library. Special thanks to the original authors for their work on the ZK protocol implementation.