macOS · Linux · Windows

MACquerade

Every device deserves a disguise. Spoof your MAC address in a single command.

$npm install -g macquerade
Read the docs

Built for disappearing acts

Cross-platform

One CLI for macOS, Linux, and Windows — with the platform quirks handled for you.

One-command install

Install globally with npm or run instantly with npx. No config, no ceremony.

Vendor spoofing

Bundled OUI database — 1691 prefixes from 98 vendors — to masquerade as any vendor.

Dry-run safety

Preview every change with --dry-run before touching a single interface.

JSON output

Machine-readable --format=json for scripts and automation pipelines.

TypeScript & ESM

A modern, fully typed rewrite shipping native ECMAScript modules.

See it in action

zsh — list
$macquerade list
- "Wi-Fi" on device "en1" with MAC address 70:56:51:BE:B3:01
zsh — vendor
$sudo macquerade randomize en0 --vendor=apple
New MAC: 00:03:93:A1:B2:C3 (Apple, Inc.)
zsh — lookup
$macquerade lookup 00:03:93:12:34:56
Apple, Inc.
zsh — vendors
$macquerade vendors
OUI Database: 1691 prefixes from 98 vendors

macOS

Uses networksetup and the airport binary. Requires sudo for changes.

Linux

Uses ip (iproute2), falls back to ifconfig. Pass --prefer-ifconfig to force it.

Windows

Uses ipconfig and the Windows Registry. Run from an Administrator shell.

macOS one-liner

Installs Homebrew + Node.js if needed, then builds and randomizes an interface you pick.

quick start
curl -fsSL https://raw.githubusercontent.com/TheJACKedViking/spoof/main/scripts/mac-randomize.sh | bash

The script is interactive and may ask for your sudo password. Read it before running, as with any piped installer.