Skip to content

README.md

Latest commit

 

History

History
71 lines (52 loc) · 1.98 KB

README.md

File metadata and controls

71 lines (52 loc) · 1.98 KB

EZMonitorModeButton

A simple Python GUI for the Raspberry Pi to easily enable and disable monitor mode on a wireless interface.

Version 1.1.0 (New!)

  • Interface Detection: Automatically detects available wireless interfaces.
  • Improved Display Handling: Better support for sudo and graphical environments.
  • Quick Tools: Shortcuts for Wireshark, Wifite, and Kismet.

Installation (Recommended)

Option 1: Debian Package (Pi/Ubuntu/Debian)

Download the latest .deb file from the Releases page and install it using:

sudo apt update
sudo apt install ./ezmonitormode_1.1.0_all.deb

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

Option 2: Via PyPI

pip install ezmonitormode

Once installed, run with sudo -E ezmonitormode.

Option 3: Running from Source

  1. Clone this repository: 
    git clone https://github.com/ldl805/EZMonitorModeButton.git
cd EZMonitorModeButton
  2. Install dependencies: 
    sudo apt update
sudo apt install python3-tk aircrack-ng wireless-tools
  3. Run the application: 
    sudo -E python3 src/ezmonitormode/monitor_gui.py

Troubleshooting

"no display name and no $DISPLAY environment variable"

This occurs if the GUI cannot find your screen.

  • Running via SSH: Ensure you connected with X11 forwarding: ssh -X user@pi.
  • Running via sudo: Use sudo -E ezmonitormode to preserve your display settings.
  • Running in Headless mode: This application requires a graphical desktop (Pi Desktop, VNC, etc.).

System Dependencies

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

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

Optional tools for the shortcut buttons:

sudo apt install wifite wireshark kismet

License

MIT License