Skip to content

Hiiirad/Mac-Changer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Change Mac Address

License

Hi everybody :)

  • There are a lot of reasons to change mac address such as anonymity, sabotage in network etc. My program will provide a lot of options for you to change your interface(s)'s mac address.
  • oui.csv file contains all of standard OUI (Organizationally Unique Identifier) part of a mac address (first half of a mac address or first 24bit of mac address)

Getting Started

This program will only works on Linux systems and I believe it would be work perfectly on Macbooks. My OS is Ubuntu 18.04 and I design this program to run on all debian-based linux systems. The installation process will be different if you use other linux distributions.

Features:

  • Everything in this program is in lowercase. So it is case-insensitive. This program has no problem working with uppercase letters, but output of program is always in lowercase.
  • Every interface and mac address that user desire to change will be validate with Regular Expression (Regex).
  • Users can decide which interface they want to change (Wireless or Ethernet).
  • Program can set a completely random mac:
    • This random mac can be just randomly selected from hex characters.
    • Or it can be based on Standard OUI from IEEE which you can access it from here (Text File and CSV File).
  • Original mac address of interfaces will be save at /tmp/ so user can reverse mac address back to normal choose reverse option.
  • Commands for apply these changes are different based on kernel version. Program can detect it and run different kind of codes. (Ubuntu 18.04's kernel version is 4.15)
  • There are more than 17K names of organizations with different OUIs which is alot to process and show users to choose from them. I used prompt_toolkit library to auto-complete names for searching in OUIs.

Prerequisites

sudo apt update && sudo apt upgrade -y
sudo apt install git

Installing

I prefer using Anaconda instead of using Pip or PyPI, but you decide which is good for you.

  • Using Pip:
    sudo apt install python3-pip
    pip install pip
    pip install -r requirements.txt
  • Using Anaconda: Installation process is completely documented here.

Upgrading

  • Pip:
    pip install -U pip
  • Anaconda:
    conda update --all

Version check to verify installation

  • Pip:
    pip --version
  • Anaconda:
    conda --version

Usage

git clone https://github.com/Hiiirad/Mac-Changer.git
cd Mac-Changer/

If kernel version of your OS is older than 4.15 you should run this program like this:

python3 mac-changer.py

Otherwise:

python mac-changer.py

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Changing Mac Address of Interface(s)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages