finds.dev← search

// the find

feross/SpoofMAC

★ 3,156 · Python · updated Jan 2018

:briefcase: Change your MAC address for debugging

SpoofMAC is a Python CLI tool for changing your MAC address on macOS, Windows, and Linux. It handles the Airport disassociation step on macOS that makes manual MAC spoofing annoying. The audience is developers and network testers who need to rotate MACs without fiddling with ifconfig by hand.

Handles the macOS-specific Wi-Fi disassociation automatically, which is the actual pain point that motivated the project. Falls back to the `ip` command on Linux distros where ifconfig is deprecated (Arch, newer Ubuntus). The launchd startup plist lets you persist the change across reboots on macOS, where the OS resets it on restart. Small, auditable codebase — three source files, no heavy dependencies.

Abandoned since 2018 and the README itself tells you to use the Node.js port instead, which is a strange recommendation to lead with in your own project. macOS network stack has changed significantly since High Sierra; the Airport disassociation logic almost certainly breaks on recent macOS versions. No tests whatsoever. Windows support is best described as 'sometimes works depending on your NIC' per the README's own admission.

View on GitHub → Homepage ↗

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →