Python wrappers around nmcli for MAC spoofing
Project description
# randommac
A MAC changer for Linux with Network Manager support
## macchanger and the NetworkManager problem
As I searched the Internet for MAC spoofing solutions, it appeared that the main tool available for Linux (*macchanger*) breaks when *NetworkManager* is used for monitoring of the connections, which is the default on for example Ubuntu 16.04 LTS. I do not want to disable *NetworkManager* so I needed to find a way to do spoofing on Linux with it.
*NetworkManager* can be controlled from command line through its utility *nmcli*. *nmcli* supports MAC spoofing through the *cloned-mac-address* option. Therefore, I wrote a few Python wrappers to help me use nmcli for performing flexible MAC spoofing
## randommac code structure
- /data/ contains an OUI.list file that is used for generating valid random MAC addresses with valid manufacturer ID.
- /randommac/ contains the code. Interaction with the code should rely on functions from randommac_interface.py for use as a Python module, or randommac for use as a command line tool.
- /examples/ contains examples of how to use the Python module. You can start by testing the random MAC number generation (python_compute_random_MAC.py), then create new dummy spoofed connections (python_new_spoofed_connection.py), inspect it (python_inspect_connection.py) and spoof it again (python_spoof_existing_connection.py). You can also have a look at the interactive interface (python_interactive_interface.py).
## installation
Simply clone this repository on you local computer.
## quick start
For a quick step-by-step demonstration of the module, try the interactive interface. Launch by executing examples/python_interactive_interface.py
## To do
This is a work in progress.
- interactive interface
- command line interface
- documentation
- examples
- release
- post answers to people having problem with NM and maccanger:
http://askubuntu.com/questions/603196/macchanger-wlan-not-working
https://github.com/alobbs/macchanger/issues/22
http://askubuntu.com/questions/173084/ubuntu-12-04-system-error-macchanger-issue
- website post?
- take care of re opening network manager if bug in one of the functions
A MAC changer for Linux with Network Manager support
## macchanger and the NetworkManager problem
As I searched the Internet for MAC spoofing solutions, it appeared that the main tool available for Linux (*macchanger*) breaks when *NetworkManager* is used for monitoring of the connections, which is the default on for example Ubuntu 16.04 LTS. I do not want to disable *NetworkManager* so I needed to find a way to do spoofing on Linux with it.
*NetworkManager* can be controlled from command line through its utility *nmcli*. *nmcli* supports MAC spoofing through the *cloned-mac-address* option. Therefore, I wrote a few Python wrappers to help me use nmcli for performing flexible MAC spoofing
## randommac code structure
- /data/ contains an OUI.list file that is used for generating valid random MAC addresses with valid manufacturer ID.
- /randommac/ contains the code. Interaction with the code should rely on functions from randommac_interface.py for use as a Python module, or randommac for use as a command line tool.
- /examples/ contains examples of how to use the Python module. You can start by testing the random MAC number generation (python_compute_random_MAC.py), then create new dummy spoofed connections (python_new_spoofed_connection.py), inspect it (python_inspect_connection.py) and spoof it again (python_spoof_existing_connection.py). You can also have a look at the interactive interface (python_interactive_interface.py).
## installation
Simply clone this repository on you local computer.
## quick start
For a quick step-by-step demonstration of the module, try the interactive interface. Launch by executing examples/python_interactive_interface.py
## To do
This is a work in progress.
- interactive interface
- command line interface
- documentation
- examples
- release
- post answers to people having problem with NM and maccanger:
http://askubuntu.com/questions/603196/macchanger-wlan-not-working
https://github.com/alobbs/macchanger/issues/22
http://askubuntu.com/questions/173084/ubuntu-12-04-system-error-macchanger-issue
- website post?
- take care of re opening network manager if bug in one of the functions
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
randommac-0.1.0a1.tar.gz
(8.4 kB
view hashes)
Built Distribution
randommac-0.1.0a1-py2.7.egg
(227.0 kB
view hashes)