@proxymanllc/better-node-machine-uid
v0.2.0
Published
Unique machine (desktop) id (no admin privileges required).doesn't use reg.exe on windows
Downloads
4
Readme
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:
- Fork the repo.
- Create a new branch for your feature/bugfix.
- Write tests for your changes.
- Implement your changes.
- Run the tests to make sure everything passes.
- 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