Menu

Tree [d3cca8] master /
 History

HTTPS access


File Date Author Commit
 .dependabot 2019-12-09 Benjamin Lupton Benjamin Lupton [f15bd0] v4.4.0 - boundation, changelog, version bump
 .github 2019-11-12 Benjamin Lupton Benjamin Lupton [e765d6] v1.5.0 - boundation, changelog, version bump
 source 2020-01-29 Benoit Sepe Benoit Sepe [ae8ce5] fix: remove unused import NetworkInterfaceInfo ...
 .editorconfig 2019-11-12 Benjamin Lupton Benjamin Lupton [e765d6] v1.5.0 - boundation, changelog, version bump
 .gitignore 2019-11-12 Benjamin Lupton Benjamin Lupton [e765d6] v1.5.0 - boundation, changelog, version bump
 .npmignore 2019-12-18 Benjamin Lupton Benjamin Lupton [74d458] v5.0.0 - commonjs must now require .default
 .travis.yml 2020-01-29 Benjamin Lupton Benjamin Lupton [b2ce51] v5.1.0 - version bump and changelog
 CONTRIBUTING.md 2020-01-29 Benjamin Lupton Benjamin Lupton [b2ce51] v5.1.0 - version bump and changelog
 HISTORY.md 2020-01-29 Benjamin Lupton Benjamin Lupton [b2ce51] v5.1.0 - version bump and changelog
 LICENSE.md 2019-11-12 Benjamin Lupton Benjamin Lupton [e765d6] v1.5.0 - boundation, changelog, version bump
 README.md 2020-01-29 Benjamin Lupton Benjamin Lupton [b2ce51] v5.1.0 - version bump and changelog
 coffeelint.json 2015-03-03 Benjamin Lupton Benjamin Lupton [bbef03] Updated meta files
 package-lock.json 2020-03-13 dependabot-preview[bot] dependabot-preview[bot] [d3cca8] [Security] Bump acorn from 7.1.0 to 7.1.1
 package.json 2020-01-29 Benjamin Lupton Benjamin Lupton [b2ce51] v5.1.0 - version bump and changelog
 tsconfig.json 2019-12-18 Benjamin Lupton Benjamin Lupton [74d458] v5.0.0 - commonjs must now require .default

Read Me

getmac

Travis CI Build Status
NPM version
NPM downloads
Dependency Status
Dev Dependency Status


GitHub Sponsors donate button
Patreon donate button
Flattr donate button
Liberapay donate button
Buy Me A Coffee donate button
Open Collective donate button
crypto donate button
PayPal donate button
Wishlist browse button

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.

CLI

Install globally npm install -g getmac, then run with getmac-node

API

Install locally npm install --save getmac, then use like so:

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() instead.

Install

npm

  • Install: npm install --save getmac
  • Import: import pkg from ('getmac')
  • Require: const pkg = require('getmac').default

Editions

This package is published with the following editions:

History

Discover the release history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

Sponsors

No sponsors yet! Will you be the first?

GitHub Sponsors donate button
Patreon donate button
Flattr donate button
Liberapay donate button
Buy Me A Coffee donate button
Open Collective donate button
crypto donate button
PayPal donate button
Wishlist browse button

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

and licensed under:

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.