Get the MAC address of the current machine you are on.
This library will not run in web browsers / on the client-side / in webpack / in browserify / in angular / in react / in jQuery / in HTML. It will only run on Node.js environments, which the web browser is not.
## Usage
[Complete API Documentation.](http://master.getmac.bevry.surge.sh/docs/)
### CLI
Install globally `npm install -g getmac`, then run with `getmac-node`
### API
Install locally `npm install --save getmac`, then use like so:
```javascript
import getMAC, { isMAC } from 'getmac'
// Fetch the computer's MAC address
console.log(getMAC())
// Fetch the computer's MAC address for a specific interface
console.log(getMAC('eth0'))
// Validate that an address is a MAC address
if (isMAC('e4:ce:8f:5b:a7:fc')) {
console.log('valid MAC')
} else {
console.log('invalid MAC')
}
```
### Advanced
If you want to do advanced filtering, use [`os.networkInterfaces()`](https://nodejs.org/dist/latest-v12.x/docs/api/os.html#os_os_networkinterfaces) instead.
npm install --save getmacimport pkg from ('getmac')const pkg = require('getmac').defaultThis package is published with the following editions:
getmac/source/index.ts is TypeScript source code with Import for modulesgetmac aliases getmac/edition-es2019/index.jsgetmac/edition-es2019/index.js is TypeScript compiled against ES2019 for Node.js 10 || 12 || 14 || 16 with Require for modulesgetmac/edition-es2019-esm/index.js is TypeScript compiled against ES2019 for Node.js 12 || 14 || 16 with Import for modulesHISTORY.md file.
CONTRIBUTING.md file.
CONTRIBUTING.md file.