8000 GitHub - parfait-code/Mac_Changer: The MAC Address Changer is a powerful and user-friendly Python tool designed to modify the Media Access Control (MAC) address. Whether you're testing network configurations, enhancing privacy, or troubleshooting connectivity issues, this tool provides a simple and efficient way to change, randomize, or restore
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

The MAC Address Changer is a powerful and user-friendly Python tool designed to modify the Media Access Control (MAC) address. Whether you're testing network configurations, enhancing privacy, or troubleshooting connectivity issues, this tool provides a simple and efficient way to change, randomize, or restore

Notifications You must be signed in to change notification settings

parfait-code/Mac_Changer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Mac_Changer -- MAC Address Changer Tool

Python License

The Mac_Changer is a Python script designed to change the Media Access Control (MAC) address of a network interface on a Linux system. This tool is useful for testing, privacy protection, or troubleshooting network issues. It uses the ifconfig command to modify the MAC address temporarily.


Features

  • Change the MAC address of a specified network interface.
  • Generate a random MAC address.
  • Restore the original MAC address.
  • List all available network interfaces.
  • Check the status (up/down) of a network interface.
  • Spoof the system hostname.
  • Comprehensive manual with usage instructions.

Requirements

  • Operating System: Linux (tested on Ubuntu, Debian, and similar distributions).
  • Python Version: Python 3.x.
  • Permissions: Root privileges (required to change the MAC address).
  • Dependencies: The ifconfig command must be installed (part of the net-tools package).

Installation

  1. Install Python 3: Ensure Python 3 is installed on your system. You can check by running:

    python3 --version
    
  • If not installed , install it using:

    sudo apt update
    sudo apt install python3
    
  1. Install net-tools: The script relies on the ifconfig command, which is part of the net-tools package. Install it using:

    sudo apt install net-tools
    
  2. Download the Script: Save the script to a file, e.g., mac_changer.py.

  3. Make the Script Executable: Run the following command to make the script executable:

    chmod +x mac_changer.py

Usage

Command Syntax

sudo python3 mac_changer.py [options]

Options

Option Description
-i, --interface Specify the network interface (e.g., eth0).
-m, --mac Specify the new MAC address.
-r, --random Generate a random MAC address.
-ro, --restore Restore the original MAC address.
-l, --list List all available network interfaces.
-s, --status Check the status of an interface (up/down).
-hn, --hostname Spoof the system hostname.
-info Display the manual.
-h, --help Show the help menu.

Examples

  1. Change MAC Address:

    sudo python3 mac_changer.py -i eth0 -m 00:11:22:33:44:55
    
  2. Generate Random MAC Address:

    sudo python3 mac_changer.py -i eth0 -r
    
  3. Restore Original MAC Address:

    sudo python3 mac_changer.py -i eth0 -ro
    
  4. List Available Interfaces:

    sudo python3 mac_changer.py -l
    
  5. Check Interface Status:

    sudo python3 mac_changer.py -s eth0
    
  6. Spoof Hostname:

    sudo python3 mac_changer.py -hn newhostname
    
  7. Display Manual:

    sudo python3 mac_changer.py -info
    

Important Notes

  • Root Privileges: This tool requires root privileges to change the MAC address.

  • Temporary Change: The MAC address change is not persistent across reboots.

  • Legal Use: Use this tool responsibly and only on networks you own or have permission to test on.


License

This tool is open-source and distributed under the MIT License. Feel free to modify and distribute it as needed.


Author

Name: Kouam Parfait J

Contact: kouamparfait5@gmail.com

GitHub: my github


Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.


Disclaimer

This tool is intended for educational and legitimate purposes only. Misuse of this tool, such as unauthorized access (without permission) to networks or illegal activities, is prohibited. The authors are not responsible for any misuse or damage caused by this tool.

About

The MAC Address Changer is a powerful and user-friendly Python tool designed to modify the Media Access Control (MAC) address. Whether you're testing network configurations, enhancing privacy, or troubleshooting connectivity issues, this tool provides a simple and efficient way to change, randomize, or restore

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0