ezmonitormode 1.0.1__tar.gz

ezmonitormode-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JWL_805
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ezmonitormode-1.0.1/PKG-INFO

@@ -0,0 +1,82 @@
+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

ezmonitormode-1.0.1/README.md

@@ -0,0 +1,65 @@
+# 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

ezmonitormode-1.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ezmonitormode"
+version = "1.0.1"
+authors = [
+  { name="ldl805" },
+]
+description = "A simple GUI to enable/disable monitor mode on wireless interfaces."
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Topic :: System :: Networking",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.scripts]
+ezmonitormode = "ezmonitormode.monitor_gui:main"
+
+[project.urls]
+"Homepage" = "https://github.com/ldl805/EZMonitorModeButton"
+"Bug Tracker" = "https://github.com/ldl805/EZMonitorModeButton/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ezmonitormode"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/ezmonitormode/*.sh",
+    "/src/ezmonitormode/*.py",
+]

ezmonitormode-1.0.1/src/ezmonitormode/monitor_gui.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python3
+import tkinter as tk
+from tkinter import messagebox
+import subprocess
+import os
+import shutil
+
+# Configuration
+INTERFACE = "wlan1"
+# Look for script in the same directory as the python script
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+STOP_SCRIPT = os.path.join(BASE_DIR, "stop_monitor_mode.sh")
+
+class MonitorGUI:
+    def __init__(self, master):
+        self.master = master
+        master.title("Monitor Mode Control")
+        master.geometry("400x350")
+        master.resizable(False, False)
+
+        # Title Label
+        self.label = tk.Label(master, text="Monitor Mode Switch", font=("Helvetica", 16, "bold"))
+        self.label.pack(pady=10)
+
+        # Status Label
+        self.status_var = tk.StringVar()
+        self.status_var.set("Ready")
+        self.status_label = tk.Label(master, textvariable=self.status_var, fg="blue")
+        self.status_label.pack(pady=5)
+
+        # Monitor Mode Controls Frame
+        self.control_frame = tk.Frame(master, borderwidth=2, relief="groove")
+        self.control_frame.pack(pady=10, padx=20, fill="x")
+
+        # ON Button (Enable)
+        self.btn_on = tk.Button(self.control_frame, text="ENABLE Monitor Mode", 
+                                bg="#90ee90", activebackground="#32cd32", # Light Green -> Lime Green
+                                font=("Helvetica", 12, "bold"),
+                                command=self.enable_monitor)
+        self.btn_on.pack(pady=10, fill="x", padx=10)
+
+        # OFF Button (Disable)
+        self.btn_off = tk.Button(self.control_frame, text="DISABLE Monitor Mode", 
+                                 bg="#ffcccb", activebackground="#ff6347", # Light Red -> Tomato
+                                 font=("Helvetica", 12, "bold"),
+                                 command=self.disable_monitor)
+        self.btn_off.pack(pady=10, fill="x", padx=10)
+
+        # Tools Label
+        self.tools_label = tk.Label(master, text="Tools Shortcuts", font=("Helvetica", 12, "bold"))
+        self.tools_label.pack(pady=(15, 5))
+
+        # Tools Frame
+        self.tools_frame = tk.Frame(master)
+        self.tools_frame.pack(pady=5)
+
+        # Tool Buttons
+        self.btn_wifite = tk.Button(self.tools_frame, text="Wifite", width=10, command=self.run_wifite)
+        self.btn_wifite.grid(row=0, column=0, padx=5)
+
+        self.btn_wireshark = tk.Button(self.tools_frame, text="Wireshark", width=10, command=self.run_wireshark)
+        self.btn_wireshark.grid(row=0, column=1, padx=5)
+
+        self.btn_kismet = tk.Button(self.tools_frame, text="Kismet", width=10, command=self.run_kismet)
+        self.btn_kismet.grid(row=0, column=2, padx=5)
+
+    def run_command(self, cmd_list, description):
+        """Helper to run commands and update status."""
+        self.status_var.set(f"Running: {description}...")
+        self.master.update()
+        try:
+            # check=True will raise CalledProcessError on non-zero exit
+            subprocess.run(cmd_list, check=True)
+            self.status_var.set(f"Success: {description}")
+            return True
+        except subprocess.CalledProcessError as e:
+            self.status_var.set(f"Error: {description}")
+            messagebox.showerror("Error", f"Failed to run {description}.\nExit code: {e.returncode}")
+            return False
+        except Exception as e:
+            self.status_var.set(f"Error: {description}")
+            messagebox.showerror("Error", f"An error occurred:\n{str(e)}")
+            return False
+
+    def enable_monitor(self):
+        """Enables monitor mode (logic from monitor_mode.sh without prompts)."""
+        if not messagebox.askyesno("Confirm", f"Enable monitor mode on {INTERFACE}?\nThis will kill network processes."):
+            return
+
+        # Step 1: Kill conflicting processes
+        if not self.run_command(["sudo", "airmon-ng", "check", "kill"], "Kill processes"):
+            if not messagebox.askyesno("Warning", "Failed to kill processes. Continue anyway?"):
+                return
+
+        # Step 2: Start monitor mode
+        if self.run_command(["sudo", "airmon-ng", "start", INTERFACE], "Start Monitor Mode"):
+            messagebox.showinfo("Success", f"Monitor mode enabled on {INTERFACE}.")
+
+    def disable_monitor(self):
+        """Disables monitor mode using the stop_monitor_mode.sh script."""
+        if not messagebox.askyesno("Confirm", "Disable monitor mode and restore networks?"):
+            return
+        
+        # Call the bash script we created
+        if self.run_command(["sudo", "bash", STOP_SCRIPT], "Disable Monitor & Restore"):
+            messagebox.showinfo("Success", "Monitor mode disabled. Network restarting...")
+
+    def get_terminal(self):
+        """Finds a suitable terminal emulator."""
+        term = shutil.which("x-terminal-emulator")
+        if not term:
+            term = shutil.which("gnome-terminal")
+        if not term:
+            term = shutil.which("konsole")
+        if not term:
+            term = shutil.which("xterm")
+        return term
+
+    def launch_in_terminal(self, cmd, title):
+        term = self.get_terminal()
+        if not term:
+            messagebox.showerror("Error", "No terminal emulator found (x-terminal-emulator, gnome-terminal, etc).")
+            return
+        
+        # Construct command based on terminal.
+        # most accept -e
+        full_cmd = [term, "-e", f"sudo {cmd}"]
+        # specialized handling if needed, but -e is standard for xterm/gnome-terminal/x-terminal-emulator
+        
+        try:
+            subprocess.Popen(full_cmd) # Non-blocking
+            self.status_var.set(f"Launched {title}")
+        except Exception as e:
+            messagebox.showerror("Error", f"Failed to launch {title}:\n{e}")
+
+    def run_wifite(self):
+        self.launch_in_terminal("wifite", "Wifite")
+
+    def run_kismet(self):
+        self.launch_in_terminal("kismet", "Kismet")
+
+    def run_wireshark(self):
+        try:
+            subprocess.Popen(["sudo", "wireshark"]) # Wireshark is GUI
+            self.status_var.set("Launched Wireshark")
+        except Exception as e:
+            messagebox.showerror("Error", f"Failed to launch Wireshark:\n{e}")
+
+def main():
+    root = tk.Tk()
+    app = MonitorGUI(root)
+    root.mainloop()
+
+if __name__ == "__main__":
+    main()

ezmonitormode-1.0.1/src/ezmonitormode/monitor_mode.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# Script to switch a wireless interface into monitor mode.
+
+INTERFACE="wlan1" # The wireless interface to put into monitor mode
+
+echo "This script will prepare your system for monitor mode by killing conflicting processes"
+echo "and then attempt to switch $INTERFACE into monitor mode."
+echo "Root privileges (sudo) will be required."
+
+read -p "Do you want to proceed? (y/N): " confirm
+if [[ ! "$confirm" =~ ^[yY]$ ]]; then
+    echo "Operation cancelled."
+    exit 0
+fi
+
+echo "Step 1: Killing conflicting processes with airmon-ng check kill..."
+if sudo airmon-ng check kill; then
+    echo "Conflicting processes killed successfully (or none were running)."
+else
+    echo "Error: Failed to kill conflicting processes. Please check the output above."
+    read -p "Do you want to continue attempting to put $INTERFACE into monitor mode anyway? (y/N): " continue_anyway
+    if [[ ! "$continue_anyway" =~ ^[yY]$ ]]; then
+        echo "Operation cancelled."
+        exit 1
+    fi
+fi
+
+echo "Step 2: Switching $INTERFACE into monitor mode..."
+# airmon-ng start usually renames the interface, often adding "mon" or changing it.
+# The output will tell us the new monitor interface name.
+MON_INTERFACE_OUTPUT=$(sudo airmon-ng start "$INTERFACE" 2>&1)
+EXIT_CODE=$?
+
+echo "$MON_INTERFACE_OUTPUT"
+
+if [ "$EXIT_CODE" -eq 0 ]; then
+    # Try to extract the new monitor interface name
+    NEW_MON_INTERFACE=$(echo "$MON_INTERFACE_OUTPUT" | grep -oP '\s\K\w+mon(?=\s+)' | tail -n 1)
+    if [ -z "$NEW_MON_INTERFACE" ]; then
+        NEW_MON_INTERFACE=$(echo "$MON_INTERFACE_OUTPUT" | grep -oP '\(monitor mode enabled on \)\K\w+' | tail -n 1)
+    fi
+
+    if [ -n "$NEW_MON_INTERFACE" ]; then
+        echo "Success: $INTERFACE is now in monitor mode as $NEW_MON_INTERFACE."
+        echo "You can now use tools like airodump-ng or Wireshark on $NEW_MON_INTERFACE."
+    else
+        echo "Success: $INTERFACE should now be in monitor mode, but could not determine new interface name."
+        echo "Please check 'iwconfig' or 'ip a' to find the new monitor interface name (e.g., 'wlan1mon')."
+    fi
+else
+    echo "Error: Failed to switch $INTERFACE into monitor mode. Please check the output above."
+    exit 1
+fi
+
+echo "Script finished."

ezmonitormode-1.0.1/src/ezmonitormode/stop_monitor_mode.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+
+# Script to disable monitor mode on wlan1 and restore network services.
+# This script is intended to be the counterpart to monitor_mode.sh
+
+# The interface usually becomes wlan1mon after airmon-ng start.
+# We will attempt to stop that, or wlan1 if wlan1mon doesn't exist.
+
+MON_INTERFACE="wlan1mon"
+ORIG_INTERFACE="wlan1"
+
+echo "Attempting to disable monitor mode..."
+
+# Try stopping wlan1mon first
+if ip link show "$MON_INTERFACE" > /dev/null 2>&1; then
+    echo "Stopping $MON_INTERFACE..."
+    sudo airmon-ng stop "$MON_INTERFACE"
+else
+    echo "$MON_INTERFACE not found. Checking for $ORIG_INTERFACE in monitor mode..."
+    # If wlan1 is in monitor mode (sometimes airmon-ng doesn't rename it)
+    sudo airmon-ng stop "$ORIG_INTERFACE"
+fi
+
+echo "Restarting network services..."
+
+# Restart NetworkManager (manages connections)
+if systemctl list-unit-files | grep -q NetworkManager; then
+    echo "Restarting NetworkManager..."
+    sudo systemctl restart NetworkManager
+fi
+
+# Restart wpa_supplicant (often handled by NM, but good to ensure)
+if systemctl list-unit-files | grep -q wpa_supplicant; then
+    echo "Restarting wpa_supplicant..."
+    sudo systemctl restart wpa_supplicant
+fi
+
+# Restart avahi-daemon (mDNS)
+if systemctl list-unit-files | grep -q avahi-daemon; then
+    echo "Restarting avahi-daemon..."
+    sudo systemctl restart avahi-daemon
+fi
+
+echo "Monitor mode disabled and services restoration requested."
+echo "Please wait a few seconds for network to reconnect."