{"id":28506502,"url":"https://github.com/fabacab/simplespoofmac","last_synced_at":"2025-06-30T19:04:04.771Z","repository":{"id":35020031,"uuid":"39123172","full_name":"fabacab/SimpleSpoofMAC","owner":"fabacab","description":":id::twisted_rightwards_arrows: Super simple launchd-style Airport/Wi-Fi card MAC address spoofer for macOS.","archived":false,"fork":false,"pushed_at":"2020-02-03T01:52:32.000Z","size":8,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-08T20:05:56.079Z","etag":null,"topics":["airport-card","launchd","mac-address-spoofing","mac-os-x","macos","network-card","spoofer"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabacab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-15T07:38:01.000Z","updated_at":"2023-05-18T11:44:57.000Z","dependencies_parsed_at":"2022-07-15T14:47:26.850Z","dependency_job_id":null,"html_url":"https://github.com/fabacab/SimpleSpoofMAC","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fabacab/SimpleSpoofMAC","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabacab%2FSimpleSpoofMAC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabacab%2FSimpleSpoofMAC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabacab%2FSimpleSpoofMAC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabacab%2FSimpleSpoofMAC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabacab","download_url":"https://codeload.github.com/fabacab/SimpleSpoofMAC/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabacab%2FSimpleSpoofMAC/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262834664,"owners_count":23371847,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airport-card","launchd","mac-address-spoofing","mac-os-x","macos","network-card","spoofer"],"created_at":"2025-06-08T20:05:49.978Z","updated_at":"2025-06-30T19:04:04.763Z","avatar_url":"https://github.com/fabacab.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple SpoofMAC (macOS Airport card MAC address spoofer)\n\nThis repository contains a very simple Apple Airport card [MAC (Media Access Control, aka \"Ethernet address\")](https://en.wikipedia.org/wiki/MAC_address) spoofer designed for macOS systems compatible with [`launchd`](http://launchd.info/). (However, it has only been tested on Apple systems ranging from Mac OS X 10.10.x Yosemite to macOS 10.14.x Mojave. YMMV.)\n\nYou might want to spoof your MAC address if you use your laptop in a lot of different environments (Starbucks FTW) and you'd prefer to appear as a \"new\" device whenever you restart. This helps protect your privacy by making it more difficult to associate your human identity with a particular device.\n\nThe best way to think about a MAC address is like a license plate for your network card; anyone on the network can see it. Unlike a license plate, though, you can (legally) change your MAC address at any time. You can [learn more about MAC address spoofing (and a bunch of other privacy-related things)](https://maymay.net/blog/2013/02/20/howto-use-tor-for-all-network-traffic-by-default-on-mac-os-x/#spoof-your-mac-address) on [my blog](https://maymay.net/blog/tag/privacy).\n\nThis script works by finding your Macintosh computer's \"Wi-Fi\" network interface card (NIC) and randomizing its \"hardware\"/\"ethernet\"/\"link-local\"/\"MAC\" address each time you restart your computer. The script is currently smart enough to work regardless of whether your Airport card is assigned the `en0` or `en1` interface device names, as long as the Airport card is called \"`Wi-Fi`\" in your Network System Preference pane.\n\nOptionally, this script can also randomize your computer's various host names. Consistent host names can reveal your identity regardless of MAC address randomization. On a macOS system, host names include:\n\n* the \"Computer Name\" (used for various \"user-friendly\" name purposes such as AFP- or SMB-based file sharing),\n* the \"Local Host Name\" (used as the network name for a local subnet, e.g., Bonjour/mDNS service auto-discovery),\n* the \"Host Name\" (used as the system's own, non-networked name such as in command line prompts)\n\nFor example, when your system is configured to obtain its IP network address via DHCP, your Computer Name is broadcast to the DHCP server as part of [DHCP option](https://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol#DHCP_options) number 12. Many people name their computers after themselves, such as `Alice Jones's Computer` or `Bob Smith's PC`, which will leak their legal identity to every DHCP server from which they request an IP address. Even if they randomize their network interface card's MAC address, their computer names will remain static and thus can be correlated to their identity.\n\n# Installing\n\nEach step in the following list of instructions is a one-liner. The steps are:\n\n1. Download.\n1. Install the `SpoofMAC.sh` script (into `/usr/local/libexec`).\n1. Install the `launchd` service.\n1. Reboot your Macintosh.\n\nThe complete process looks like this:\n\n```sh\ngit clone https://github.com/meitar/SimpleSpoofMAC.git       # Download.\ncd SimpleSpoofMAC\nsudo mkdir -p /usr/local/libexec\nsudo cp SpoofMAC.sh /usr/local/libexec                       # Install script.\n# Install ONE (not both) of the launchd service jobs. (This defaults to the MAC and name spoofing service.)\nsudo cp local.SpoofMACandName.plist /Library/LaunchDaemons \\\n  || sudo cp local.SpoofMAC.plist /Library/LaunchDaemons\nsudo shutdown -r +1 \"Rebooting in 1 minute.\"                 # Reboot your Macintosh.\n```\n\n## Using a custom computer name list\n\nYou can customize the random computer names the script chooses by supplying a names file with one name per line. For example:\n\n```\nalice\nbob\nmallory\n```\n\nWhen your system boots up, the script will randomly choose one of these three names to set as your computer's name.\n\nTo set a names file, edit the [`local.SpoofMACandName.plist`](local.SpoofMACandName.plist) file, setting the value of the `SIMPLE_SPOOF_MAC_NAMES_FILE` environment variable to the absolute path to a names file on your filesystem. Uncompressed wordlists such as those provided by [SecLists](https://github.com/danielmiessler/SecLists) make a good choice for such a names file.\n\n# Alternatives\n\n[Feross Aboukhadijeh wrote a handy tool in Python](https://github.com/feross/SpoofMAC) to do the same thing as this script though I'm unsure if it handles hostname randomization as completely as this script does. Feross's tool also supports Windows and Linux computers. I wrote this because I don't like the idea of a Python dependency for such a basic sysadmin task as spoofing a MAC address or hostname. Use Feross's script if you want a cross-platform solution. Use this script if you also think Python, while swell, is probably overkill for this sort of thing, and if you want a more Macintosh-specific solution for ensuring hostname randomization.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabacab%2Fsimplespoofmac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabacab%2Fsimplespoofmac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabacab%2Fsimplespoofmac/lists"}