Skip to content

Commit

Permalink
Update Readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
HalilDeniz authored Dec 8, 2023
1 parent b6f280e commit c6ed2d7
Showing 1 changed file with 43 additions and 19 deletions.
62 changes: 43 additions & 19 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,10 @@ MacMaster is a versatile command line tool designed to change the MAC address of
- **Reset to Original:** Reset the MAC address to its original hardware value.
- **Custom OUI:** Set a custom Organizationally Unique Identifier (OUI) for the MAC address.
- **Version Information:** Easily check the version of MacMaster you are using.

- **Network Interface Listing:** Easily list all available network interfaces.
- **Interface Mode Switching:** Switch wireless network interfaces between 'managed' and 'monitor' modes.
- **Network Services Reset:** Quickly reset networking services to apply changes or troubleshoot.
- **Network Traffic Monitoring:** Monitor MAC traffic in real-time for analysis and security testing.

## **Installation**
MacMaster requires Python 3.6 or later.
Expand All @@ -30,55 +33,76 @@ MacMaster requires Python 3.6 or later.

## Usage
```bash
$ macmaster --help
usage: macmaster [-h] [--interface INTERFACE] [--version]
$ macmaster
usage: macmaster [-h] [--interface INTERFACE] [--list-interfaces] [--version]
[--random | --newmac NEWMAC | --customoui CUSTOMOUI | --reset]
[--mode {managed,monitor,master,auto,repeater}] [--restart-network] [--monitor-mac-traffic]
MacMaster: Mac Address Changer
options:
-h, --help show this help message and exit
--interface INTERFACE, -i INTERFACE
Network interface to change MAC address
--list-interfaces, -li
List all network interfaces
--version, -V Show the version of the program
--random, -r Set a random MAC address
--newmac NEWMAC, -nm NEWMAC
Set a specific MAC address
--customoui CUSTOMOUI, -co CUSTOMOUI
Set a custom OUI for the MAC address
--reset, -rs Reset MAC address to the original value
--mode {managed,monitor,master,auto,repeater}
Change interface mode to managed or monitor
--restart-network, -rn
Restart network services
--monitor-mac-traffic, -mmt
Live Monitor Mac traffic
```
## Arguments

- `--interface`, `-i`: Specify the network interface.
- `--random`, `-r`: Set a random MAC address.
- `--newmac`, `-nm`: Set a specific MAC address.
- `--customoui`, `-co`: Set a custom OUI for the MAC address.
- `--reset`, `-rs`: Reset MAC address to the original value.
- `--version`, `-V`: Show the version of the program.

## Arguments
- `--interface`, `-i`: Specify the network interface to be used for MAC address operations.
- `--random`, `-r`: Generate and set a random MAC address on the specified interface.
- `--newmac`, `-nm`: Set a specific MAC address on the specified interface.
- `--customoui`, `-co`: Set a custom Organizationally Unique Identifier (OUI) for the MAC address on the specified interface.
- `--reset`, `-rs`: Reset the MAC address of the specified interface to its original hardware value.
- `--version`, `-V`: Show the current version of MacMaster.
- `--list-interfaces`, `-li`: List all network interfaces available on the system.
- `--mode`, `-m`: Change the mode of a wireless network interface (options include 'managed', 'monitor', 'master', 'auto', 'repeater').
- `--restart-network`, `-rn`: Restart network services to apply changes or troubleshoot network issues.
- `--monitor-mac-traffic`, `-mmt`: Monitor and display MAC traffic in real-time on the specified interface.

### Examples

1. **Set a specific MAC address:**
```bash
$ macmaster.py -i eth0 -nm 00:11:22:33:44:55
macmaster -i eth0 -nm 00:11:22:33:44:55
```
2. **Set a random MAC address:**
```bash
$ macmaster.py -i eth0 -r
macmaster -i eth0 -r
```
3. **Reset MAC address to its original value:**
```bash
$ macmaster.py -i eth0 -rs
macmaster -i eth0 -rs
```
4. **List all network interfaces:**
```bash
macmaster -li
```
5. **Change interface mode:**
```bash
macmaster -i eth0 -m monitor
```
4. **Set a custom OUI:**
6. **Restart network services:**
```bash
$ macmaster.py -i eth0 -co 08:00:27
macmaster -rn
```
5. **Show program version:**
7. **Monitor MAC traffic in real-time:**
```bash
$ macmaster.py -V
macmaster -i eth0 -mmt
```
Replace `eth0` with your desired network interface.

## Note

Expand Down

0 comments on commit c6ed2d7

Please sign in to comment.