Named after getmac and chmod, chmac is a command-line-interface (CLI) tool for Windows that changes or randomizes MAC addresses of specified network adapters, e.g. for a client device to reuse public Wi-Fi hotspot that has exceeded usage limit for the day (e.g. hotels, restaurants), or to enhance security.
An easy-to-use interactive console is available, alongside command-line parameters, e.g. for scheduling jobs with Task Scheduler. ChMac also has built-in support for recurrence.
For a quick start, refer to Examples section. Scroll down for more screenshots.
For download of the latest version (portable application & per-user/all-users installer), please visit GitHub Releases:
After downloading and extracting ChMac.zip, ChMac.bat portable application can be used immediately. Alternatively, Setup.exe (optional) provides installation into Current User or All Users location.
For users of Chocolatey and winget repositories who prefers unattended installation into All Users location:
choco install chmacwinget install chmac
*Note for winget users: Please ignore the warning from SmartScreen, where you may safely click 'more info' to complete installation.
- Change MAC addresses on Windows automatically or manually
- Automatically change MAC addresses on set intervals
- Useful to reconnect to free public Wi-Fi hotspots that impose a time limit by recognizing MAC addresses to prevent the same device from reconnecting
- Automatically change MAC addresses on set intervals
- Randomize MAC addresses for better security using public Wi-Fi
- Generate new MAC addresses randomly based on a customizable list of organizationally unique identifiers (OUI)
- Optionally leverage DevCon.exe to simply the process by automatically disabling and re-enabling network interface card (NIC)
- ChMac also works without DevCon by showing the Network Connections folder when finished, so that users can manually disable and re-enable NIC for new settings to take effect
- On first launch, users are guided to download DevCon with convenient automatic and manual options
- Restore original MAC address
- Error checking and rich return codes for scripting and other possibilities
- Free and open-source software written in Windows batch language
- Supports Windows 2000/XP/Vista/7/8/8.1/10 and Server 2000/2003/2008/2012/2016/2019
- Portable by default. Optional installer enables
chmaccommand globally (in Command Prompt and Run prompt. For PowerShell prompt, the command would bechmac.bat) - Easy-to-use interactive console as well as accepting command-line parameters
- Just follow instructions on screen for using the interactive console. For command-line mode, see the following
ChMac works by querying a list of network adapters from Windows registry under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4D36E972-E325-11CE-BFC1-08002BE10318}.
Based on user selection, ChMac updates the registry key responsible for the MAC address, NetworkAddress, of the corresponding adapter with an inputted or randomized MAC address from customizable OUI lists, either ad-hoc or automatically with Task Scheduler or its built-in auto-changing mechanism.
After MAC address is updated, the network adapter will be automatically disabled and re-enabled if an OS-specific DevCon.exe (a separate download from Microsoft) is available in the OS (the environmental variable, PATH) or under ChMac dependency directory, ChMac\Data\3rdparty. For more details, refer to Dependencies section.
If DevCon is unavailable, the Network Connections window will be presented to user where network adapter can be disabled and re-enabled manually.
chmac.bat [/d dir][/l][/m address][/n id][/r][/help][/?]
/d dir :: working directory - maybe required
(MUST be specified before other parameters)
/l :: list network adapters and their IDs
/m :: new mac address to be applied.
/n :: adapter to be applied new mac address if /m is unspecified
new mac address will be randomized (OUI kept) and automatically filled in
/r :: restore to original MAC address
/a :: auto-change interval
suffix may be s for seconds, m for minutes, h for hours or d for days
e.g. enter '20m' to recur every 20 mins. [X] to reset or exit
When no parameter is specified, interactive mode is entered on launch.
The MAC address format can be any of the following:
AB-CD-EF-12-34-56
AB:CD:EF:12:34:56
AB.CD.EF.12.34.56
AB CD EF 12 34 56 :: without any separation in between at all
Note: To increase success rate of changing MAC addresses in Windows Vista and later OS, the OUI lists included in ChMac contains MAC addresses which starts with 02 only
chmac /l :: list available adapter IDs
chmac /n 1 :: update network adapter #1 with randomized mac address numbers
chmac /m 00301812AB01 /n 2 :: update network adapter #2 with the new mac address: 00-30-18-12-AB-01
chmac /n 3 /r :: restore adapter 3 to its original MAC
chmac /n 4 /a 20m :: auto-change MAC per 20 minute
chmac /? :: shows short help. [/help] for long
Simply run chmac.bat and follow on-screen instructions.
ChMac :: Main directory
│ chmac.bat :: Main script
| Setup.exe :: Optional installer enabling chmac command globally (in Command Prompt and Run prompt)
│ Readme.txt :: Documentation
│
└───Data
│ OUI_NT5.txt :: Customizable list of organizationally unique identifiers for Windows XP/2003 and earlier
│ OUI_NT6.txt :: Customizable list of organizationally unique identifiers for Windows Vista and later
│ _choiceMulti.bat :: Sub-script by wandersick for providing a fallback to systems without choice.exe (XP/2003)
│ _choiceYN.bat :: Sub-script by wandersick for providing a fallback to systems without choice.exe (XP/2003)
│
└───3rdparty :: Dependencies put to the top of PATH (higher priority than system PATH entries)
│ grep.exe :: GNU Linux utility included
│ libeay32.dll :: GNU Linux library included
│ libiconv2.dll :: GNU Linux library included
│ libintl3.dll :: GNU Linux library included
│ libssl32.dll :: GNU Linux library included
│ sed.exe :: GNU Linux utility included
│ sleep.exe :: GNU Linux utility included
│ tr.exe :: GNU Linux utility included
│ wc.exe :: GNU Linux utility included
│ wget.exe :: GNU Linux utility included
│ which.exe :: GNU Linux utility included
│ devcon.exe :: Optional: place OS-specific devcon.exe from Microsoft here
│
└───LP :: Dependencies put to the bottom of PATH (lower priority than system PATH entries)
Readme.txt :: Reminders for LP directory
choice.exe :: Optional: already included in OS since Windows Vista
getmac.exe :: Optional: already included in OS since Windows XP/2003
reg.exe :: Optional: already included in OS since Windows XP/2003
OUI (organizationally unique identifier) files are available in ChMac. Add desired OUIs there for randomization while using the [G] command to generate a new MAC address.
- Not all OUIs work - begin with
02for a higher success rate on Windows Vista or later.- For technical details, see: http://blog.technitium.com/2011/05/tmac-issue-with-wireless-network.html
Filenames:
OUI_NT5.txt- for Windows 2000, XP and 2003OUI_NT6.txt- for Windows Vista and later
File Content (Default):
Vendor=OUI
3Com=020475
Atheros=021374
Broadcom=020AF7
Cisco=020D28
Intel=020CF1
Linksys=020E08
Bigfoot=021903
Marvell=025043
NVIDIA=02044B
Realtek=02E04C
VIA=02127B
Display short help - chmac /?
1: List available network adapters - chmac /l
2: Change MAC address of adapter #6 with a random MAC address - chmac /n 6
3: In case DevCon.exe is unavailable, Network Connections window will automatically be presented where user can manually disable and re-enable adapter
The above is only needed if DevCon.exe unavailable. Refer to Dependencies section for more information.
4: MAC address successfully changed
5: Interactive mode (with an additional option for auto-changing) - chmac.bat
6: Interactively configure auto-changing interval with a 20-min interval - 20m
7: Afterwards, select adapter #6 so that its MAC address is auto-changed every 20 mins - 6
8: MAC address successfully changed and waiting for next auto-changing cycle
9 (Bonus): Press R after choosing an adapter (while not in auto-changing mode) to restore original MAC address - R
Likewise, if required, press O to edit OUI lists using system-default text editor.
All Windows operating systems from Windows 2000 and up (Windows 10 1809 at the moment) are supported.
- To use this in Windows 2000 or some minimal Windows PE, place these files from another machine which runs English Windows XP or 2003:
msvcp60.dllas well asgetmac.exeandreg.exeintoChMac\Data\3rdparty\LP.
Admin rights are required for editing MAC addresses, disabling and re-enabling network adapters.
- Since version 1.3, ChMac automatically elevates itself if there is no admin rights when User Account Control (UAC) is enabled in the system
ChMac wraps around DevCon (optional), Windows-native and GNU Linux utilities
All of the below dependencies are either optional or do not require attention, as most of them are included already.
-
Optionally enhances ChMac using
DevCon.exe, Microsoft Windows Device Console which can be downloaded during first launch of the script
- Beware of the version to download as there are lots of DevCon versions for different OS. See https://superuser.com/a/1099688/112570
-
Unix utilities leveraged by ChMac are included already:
tr.exe,sed.exe,which.exe,sleep.exe,wc.exe,wget.exe,grep.exe -
Other OS built-in dependencies natively in Windows since Windows XP:
getmac.exe,reg.exe,msvcp60.dll -
Optional OS built-in dependency natively in Windows since Windows Vista:
choice.exe, automatically falling back toset /pif unavailable or when there are more than 8 network adapters, thru a sub-script,_choiceMulti.bat- https://github.com/wandersick/ws-choicechoice.exemay be put here to enhance experiences in OS earlier than Windows Vista or Server 2003- Do not copy
choice.exefrom Windows Vista or later but the one in Windows Server 2003 or Windows Resource Kit (9x/NT)
Notes
getmac.exeandreg.exeshould be put insideChMac\Data\3rdparty\LP(low priority) so that they do not override the version in the OS when a better version is available natively thru the OS- Other executables should be put inside
ChMac\Data\3rdparty(high priority) so that they override the version in the OS in case one is available natively thru the OS
Return code: 0
- Cause
- Success
Return code: 1
- Cause
- Failure
Return code: 3
- Cause
- NIC error
- Messages
- Error: No network adapter found
- Error: Adapter in a nonoperational state
- Error: Adapter unplugged. Please connect first
Return code: 4
- Cause
- Bad syntax
- Messages (and related parameters)
- Syntax Error: Working directory (/d)
- Syntax Error: Wrong address length (/m)
- Syntax Error: Not hexadecimal (/m)
- Syntax Error: Not digit (/n)
- Syntax Error: Not digit or smhd (/a)
- Syntax Error: Working directory (/d)
- Syntax Error: Missing parameter /n (/m)
- Syntax Error: Please use "/" instead of '-'
- Syntax Error: Unknown parameter
- Syntax Error: Adapter ID unavailable (/n)
Return code: 5
- Cause
- No exe is found
- Messages
- Error: No reg.exe. Place one from Windows in "ChMac\Data\3rdparty\LP"
- Error: No getmac.exe. Place one from Windows in "ChMac\Data\3rdparty\LP"
Return code: 7
- Cause
- No admin rights
- Messages
- Error: No admin right. Please run as admin
- Some virtual adapters may be unsupported
- Randomization logic randomizes numbers (0-9) instead of hexadecimal (0-9, A-F)
Below is one of the kind comments left by ChMac users. (Thanks!)
| Ver | Date | Changes |
|---|---|---|
| 2.0 | 20200627 | - Add setup.exe for an installation option alongside existing portable mode, adding to Run prompt and PATH environmental variable to enable the 'ChMac' command anywhere for ease of use - Fix (remove) EnableLUA debug message that is displayed during UAC elevation - Wrap exclamation marks around ChMacDir variable to handle parentheses - Fix a bug where ChMac (Command Prompt) does not totally exit at the end - Improve UAC elevation mechanism so that it supports Run prompt |
| 1.3 | 20200614 | - Elevate as administrator as needed when User Account Control (UAC) is enabled in the system |
| 1.2 | 20190629 | - Improve compatibility on Windows 10 by changing binaries of GNU Linux utilities - Handle cases when the system PATH variable contains parenthesis |
| 1.1 | 20120916 | Interim release |
| 1.0 | 20100124 | First released in 2010 |