1.0.2 • Published 11 months ago

@polypane/node-machine-uid v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
11 months ago

CI

node-machine-uid

node-machine-uid is a Node.js library for generating machine-unique identifiers. This library is a fork of the popular node-machine-id library, with modifications to fix an issue on Windows where reading the registry is disabled due to access rights. node-machine-uid uses the registry-js library to get the machine ID on Windows, which does not require the use of reg.exe.

Cross-platform unique machine (desktop) id discovery

Use cases

  • Software restrictions
  • Installation tracking

Features

  • Hardware independent
  • Unique within the OS installation
  • No elevated rights required
  • No external dependencies and does not require any native bindings
  • Cross-platform (OSx, Win, Linux)

Installation

To install node-machine-uid in your project, run:

bashCopy code

$ npm install node-machine-uid

Usage

To use node-machine-uid:

import machineId from "node-machine-uid"

const id = machineId()

console.log(id)

This will output a unique 64 character identifier in the following format: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

On Windows, node-machine-uid uses registry-js to get the machine ID, which does not require the use of reg.exe. Instead, it generates a unique ID based on the computer name and the processor architecture.

Contributing

Contributions to node-machine-uid are welcome! If you would like to contribute, please follow these steps:

  1. Fork the repo.
  2. Create a new branch for your feature/bugfix.
  3. Write tests for your changes.
  4. Implement your changes.
  5. Run the tests to make sure everything passes.
  6. Submit a pull request.

License

node-machine-uid is licensed under the MIT License. See the LICENSE file for more information.

Acknowledgments

The node-machine-uid library is a fork of the node-machine-id library. Special thanks to the original authors for creating such a useful library!

node-machine-uid also uses the registry-js library to get the machine ID on Windows. Thank you to the `registry