Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

node-machine-uid

Alucard17684MIT1.0.2TypeScript support: included

Unique machine (desktop) id (no admin privileges required).doesn't use reg.exe on windows

unique id, license, trial, user license, user id, machine id, unique platform id, node platform id, unique identifier, restrictions, electron id, nw.js id

readme

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