spoof

Easily spoof your MAC address in macOS, Windows, & Linux!

Github stars Tracking Chart

spoof travis npm downloads javascript style guide

Easily spoof your MAC address in macOS, Windows, & Linux!

Node.js port of the popular SpoofMAC Python utility (GitHub: feross/SpoofMAC).

anonymous

Why?

I made this because changing your MAC address on macOS is harder than it should be. The Wi-Fi card needs to be manually disassociated from any connected networks in order for the change to apply correctly – super annoying! Doing this manually each time is tedious and lame.

Instead, just run spoof and change your MAC address in one command.

Now for Windows and Linux, too!

Instructions for beginners

Here are some easy install instructions for complete beginners.

  1. Install node.js (it's a programming platform like Python, Java, etc.)

  2. Open Terminal. Let's use Spotlight to find it.

terminal

  1. Install spoof by typing this command and pressing Enter.
npm install spoof -g

That's it! spoof is installed.

  1. Now, let's print out the help page. Just like before, run this command in Terminal.
spoof --help
  1. Now, let's print out all our network devices.
spoof list
  1. Find the device you want to set or randomize the MAC address for in the list. Wi-Fi is usually called en0 on modern Macs. Then, run this command:
sudo spoof randomize en0

You may need to reconnect to the Wi-Fi hotspot you were connected to. But, that's it! Your MAC address is changed. You can confirm by re-running:

spoof list

Full command list

You can always see up-to-date usage instructions by running spoof --help.

List available devices

spoof list
- "Ethernet" on device "en0" with MAC address 70:56:51:BE:B3:00
- "Wi-Fi" on device "en1" with MAC address 70:56:51:BE:B3:01 currently set to 70:56:51:BE:B3:02
- "Bluetooth PAN" on device "en1"

List available devices, but only those on Wi-Fi

spoof list --wifi
- "Wi-Fi" on device "en0" with MAC address 70:56:51:BE:B3:6F

Randomize MAC address (requires root)

You can use the hardware port name, such as:

spoof randomize wi-fi

or the device name, such as:

spoof randomize en0

Set device MAC address to something specific (requires root)

spoof set 00:00:00:00:00:00 en0

Reset device to its original MAC address (requires root)

While not always possible (because sometimes the original hardware MAC
isn't available), you can try setting the MAC address of a device back
to its burned-in address using reset:

spoof reset wi-fi

On macOS, another option to reset your MAC address is to simply restart your
computer. macOS doesn't preserve changes to your MAC address between restarts.

Linux support?

Yep!

Linux support requires the ifconfig utility to be installed. It comes
pre-installed with most Linux distributions.

Windows support?

Yep!

Automatically randomize MAC address on startup

If you want to set or randomize your MAC address and have it persist between restarts on
macOS, consider using the Python version of this program,
SpoofMAC, and following the instructions
for running automatically on startup.

License

MIT. Copyright Feross Aboukhadijeh.

Main metrics

Overview
Name With Ownerfeross/spoof
Primary LanguageJavaScript
Program languageJavaScript (Language Count: 1)
Platform
License:MIT License
所有者活动
Created At2014-03-21 08:48:49
Pushed At2020-11-05 00:50:22
Last Commit At2020-11-04 14:50:17
Release Count19
Last Release Namev2.0.4 (Posted on 2020-11-04 14:50:17)
First Release Namev0.1.0 (Posted on 2014-03-21 01:49:12)
用户参与
Stargazers Count1.8k
Watchers Count28
Fork Count102
Commits Count107
Has Issues Enabled
Issues Count35
Issue Open Count10
Pull Requests Count11
Pull Requests Open Count1
Pull Requests Close Count1
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private