Metadata-Version: 2.4
Name: ezmonitormode
Version: 1.0.1
Summary: A simple GUI to enable/disable monitor mode on wireless interfaces.
Project-URL: Homepage, https://github.com/ldl805/EZMonitorModeButton
Project-URL: Bug Tracker, https://github.com/ldl805/EZMonitorModeButton/issues
Author: ldl805
License: MIT
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# EZMonitorModeButton

A simple Python GUI for the Raspberry Pi to easily enable and disable monitor mode on a wireless interface (default: `wlan1`).

## Features
- **One-click Enable:** Kills conflicting processes and enables monitor mode.
- **One-click Disable:** Stops monitor mode and restores network services.
- **Shortcuts:** Quick buttons to launch common security tools like Wifite, Wireshark, and Kismet.

## Installation (Recommended)

### Option 1: Via PyPI (Modern)

You can install `ezmonitormode` directly from PyPI. Note that you still need the system dependencies (see below).

```bash
pip install ezmonitormode
```

Once installed, you can launch it by running `ezmonitormode` in the terminal (usually requires `sudo`).

### Option 2: Debian Package (Pi/Ubuntu/Debian)

Download the latest `.deb` file from the [Releases](https://github.com/ldl805/EZMonitorModeButton/releases) page and install it using:

```bash
sudo apt update
sudo apt install ./ezmonitormode_1.0_all.deb
```

Once installed, you can launch it from your application menu or by running `ezmonitormode` in the terminal.

### Option 3: Running from Source

1.  **Clone this repository:**
    ```bash
    git clone https://github.com/ldl805/EZMonitorModeButton.git
    cd EZMonitorModeButton
    ```
2.  **Run the installation script** to install dependencies:
    ```bash
    chmod +x install.sh
    ./install.sh
    ```
3.  **Run the application:**
    ```bash
    sudo python3 src/ezmonitormode/monitor_gui.py
    ```

## System Dependencies

Before running `ezmonitormode`, ensure you have the following system tools installed:

```bash
sudo apt update
sudo apt install python3-tk aircrack-ng wireless-tools
```

Optional tools for the shortcut buttons:
```bash
sudo apt install wifite wireshark kismet
```

## License
MIT License
