Repository files navigation

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

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 runspoof and change your MAC address in one command.

Now for Windows and Linux, too!

Here are some easy install instructions for complete beginners.

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

2. OpenTerminal. Let's use Spotlight to find it.

3. Installspoof by typing this command and pressingEnter.

npm install spoof -g

That's it!spoof is installed.

3. Now, let's print out thehelp page. Just like before, run this command inTerminal.

spoof --help

4. Now, let's print out all our network devices.

spoof list

5. Find the device you want to set or randomize the MAC address for in the list. Wi-Fi is usually calleden0 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

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

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 currentlyset to 70:56:51:BE:B3:02-"Bluetooth PAN" on device"en1"

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

You can use the hardware port name, such as:

spoof randomize wi-fi

or the device name, such as:

spoof randomize en0

spoofset 00:00:00:00:00:00 en0

While not always possible (because sometimes the original hardware MACisn't available), you can try setting the MAC address of a device backto its burned-in address usingreset:

spoof reset wi-fi

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

Yep!

Linux support requires theifconfig utility to be installed. It comespre-installed with most Linux distributions.

Yep!

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

MIT. CopyrightFeross Aboukhadijeh.