#uuid #machine-id #hwid #machineuid #hardware-id #sha-1

machineid-crystal

Get an encrypted unique MachineID/HWID/UUID. Inspired by .Net DeviceId.

1 stable release

new 1.2.5 Feb 20, 2025

#51 in Accessibility


Used in crystal-server

MIT/Apache

32KB
661 lines

MachineID for Rust - Like .Net DeviceId

This crate is a fork of the original crate to provide some fixes and maintenance. This Rust package is inspired by DeviceId, a .Net package to build a unique Machine ID.

Features

  • 3 Different hashing types (MD5, SHA1, SHA256)
  • Different components to make the ID
  • Support for Windows, Linux and MacOS
  • No Admin privileges are required

How to use

First add this to your Cargo.toml file

[dependencies]
machineid-crystal = "1.2.5"

Then, you need to define the builder variable with the hashing type you want.

For example, SHA256

use machineid_crystal::{IdBuilder, Encryption};

// There are 3 different hashing types: MD5, SHA1 and SHA256.
let mut builder = IdBuilder::new(Encryption::SHA256);

After that, you just need to add the components you want the id to have.

The available components are:

  • System UUID: Unique identifier of your machine

  • CPU Cores: Number of physical cores from your computer

  • OS Name: Operative System name, i.e., linux/windows

  • Username: The username currently being used

  • Machine Name: The name of the machine

  • CPU ID: The serial number of the processor

  • Drive Serial : The serial number of the disk storing the OS.

For example, i will add the System UUID and CPU Cores

use machineid_crystal::HWIDComponent;

builder.add_component(HWIDComponent::SystemID).add_component(HWIDComponent::CPUCores);

Once you are ready, you just need to build the id with your key

let hwid = builder.build("mykey").unwrap();

Todo

  • Optimize the code
  • Fix bugs and increase platform integration/stability

Feel free to report any bug you find! ;)

Dependencies

~2–28MB
~404K SLoC