A media access control address is a unique identifier assigned to a network interface controller for use as a network address in communications within a network segment. This use is common in most IEEE 802 networking technologies, including Ethernet, Wi-Fi, and Bluetooth. We would like to change it sometimes due to security reasons.
Mac Address is a 12-digit hexadecimal number (6-Byte binary number), which is mostly represented by Colon-Hexadecimal notation. First 6-digits (say 00:40:96) of MAC Address identifies the manufacturer, called as OUI (Organizational Unique Identifier).
The tool is compatible with linux distributions only. Tested on:
- Ubuntu [16.04.7, 18.04.6, 20.04.6, 22.04.5, 24.04.2]
- Debian [8, 9, 10, 11, 12]
- Kali [2021.4a, 2022.4, 2023.4, 2024.4, 2025.1]
- Raspbian [8, 9, 10, 11, 12]
chmod +x setup.sh
sudo ./setup.sh
- Check for your wifi/bluetooth/ethernet interface name:
ifconfig -a
- View help and usage instructions:
python3 main.py --help
- Run the tool as administrator with your interface name:
sudo python3 main.py -i <interface>
- Run it in auto mode (non-interactive):
sudo python3 main.py -i <interface> --auto
-i- Network interface name (e.g., wlan0, eth0) [Required]--auto- Non-interactive mode: generate and apply a safe random unicast MAC address--ci- CI mode: for automated testing (similar to --auto but with different output)--help- Show help message and usage examples--version- Show version information
-
Wireshark known vendors "manuf" file
- Feel free to add more known manufactures to
src/utils/vendors.py
- Feel free to add more known manufactures to