# SpoofMAC

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

Repository: https://github.com/feross/spoof
Canonical: https://ross.abutalabs.com/products/spoofmac
Homepage: https://feross.org/spoofmac/
Language: JavaScript
License: MIT
License Family: permissive
Topics: spoof, javascript, nodejs, wifi, mac, linux, spoofmac
Last push: 2020-11-05T00:50:22+00:00
Link (homepage): https://feross.org/spoofmac/
Link (site_page): https://feross.org/about

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4548, "days_push": 2128, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1868, forks 116 (observed 2026-08-28T04:05:46.412269+00:00)

## What it is
SpoofMAC is a Python command-line tool that changes (spoofs) your computer's MAC address in one command, handling the Wi-Fi disassociation step that makes this tedious on macOS. It works on macOS, Windows, and Linux, and a Node.js port called 'spoof' is also available.

## Use cases
- change my mac address from the command line
- spoof mac address on mac os x wifi
- debug network issues by faking my mac address
- get on a wifi network that whitelists a specific mac address
- make my mac address persist across reboots
- randomize mac address on windows or linux

## When to choose
- you need a simple one-command MAC address change on macOS, Windows, or Linux
- you want to avoid manually disassociating the Airport Wi-Fi card before changing the address
- you want a startup script so the spoofed MAC persists across reboots

## When to avoid
- you need a maintained tool with recent releases and active development
- you need a GUI for changing network settings
- you need per-connection automatic MAC randomization like modern OS built-in features

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: security, networking, cli, developer-tools
- domain: networking, security, developer-tools
- platform: windows, cli, python
- tags: mac-address-spoofing, wifi, network-debugging, privacy, macchanger, command-line, macos, linux, nodejs

## Member repositories
- feross/spoof (main) score 32
- feross/SpoofMAC (mirror) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:46.412269+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:45:32.829380+00:00, confidence not recorded.
  - readme: https://github.com/feross/spoof (fetched 2026-08-28T04:05:46.412269+00:00, sha f9b90b1d10ae)
  - homepage: https://feross.org/spoofmac/ (fetched 2026-08-29T09:40:13.478924+00:00, sha ba3b11394c9e)
  - site_page: https://feross.org/about (fetched 2026-08-29T09:40:13.481574+00:00, sha acb9198aee56)
  - registry_npm: https://registry.npmjs.org/spoof (fetched 2026-08-29T09:40:13.483409+00:00, sha d7098ae0a290)
- Data as of 2026-08-30T08:39:29.467469+00:00.