Skip to content

README.md

Latest commit

 

History

History
70 lines (46 loc) · 1.62 KB

README.md

File metadata and controls

70 lines (46 loc) · 1.62 KB

🛰️ Monitor Mode Toggle Script

This Bash script allows you to toggle a wireless network interface into and out of monitor mode, with an optional built-in test to verify packet injection capability using aireplay-ng.

📦 Features

  • Enable or disable monitor mode for any given Wi-Fi interface
  • Kills conflicting processes when enabling monitor mode
  • Restores NetworkManager after disabling monitor mode
  • Optional test to confirm monitor mode + injection using:
    • iwconfig
    • aireplay-ng --test

🚀 Usage

  1. Make the script executable:

    chmod +x monitor-toggle.sh

  2. Run the script:

    ./monitor-toggle.sh

  3. Follow the prompts:

    • Enter your wireless interface name (e.g., wlan0)
    • Choose on to enable monitor mode or off to revert to managed mode
    • If turning monitor mode on, you’ll be asked if you want to run a test

🧪 Monitor Mode Test (Optional)

When prompted, say y to run a test that:

  • Displays iwconfig mode output
  • Runs aireplay-ng --test <interface> to confirm injection support

✅ Requirements

  • A wireless adapter that supports monitor mode and packet injection
  • Kali Linux (or any Linux with aircrack-ng)
  • Tools installed: 
    sudo apt update
sudo apt install aircrack-ng

⚠️ Disclaimer

This script is intended for educational and authorized cybersecurity research only.
Do not use on networks or systems you don’t have explicit permission to test.
Respect privacy laws and ethics always.

🧠 Author

Made by Merull Shah