NullSwitch

Huh ?

NullSwitch is a lightweight, command-line-based wireless network auditing toolkit designed for the ESP8266 microcontroller. It provides a suite of tools for scanning, monitoring, and simulating wireless activity, with the goal of supporting educational, research, and authorized penetration testing scenarios.

Available Commands

Current Features

Command-Line Interface (CLI) Command history traversal Auto tab completion Cursor control and navigation	Network Scanning and Monitoring Scan for nearby Wi-Fi networks Monitor active devices connected to discovered networks
Packet Monitoring Auto or locked channel mode Detects and notifies on deauth attacks	Beacon Attack Module Generate and broadcast fake access points Intended to confuse network scanners

Legal Notice

Important

This software is intended solely for educational, research, and authorized security auditing purposes.

• The authors do not endorse or condone any unauthorized or malicious use.
• Use of this tool without proper authorization may violate local, national, or international laws.
• You are fully responsible for any misuse. Only use this software in environments where you have explicit permission to operate.

By using this software, you agree to:

• Use it only in lawful and authorized contexts.
• Accept full responsibility for your actions.
• Release the developers from any liability or legal consequences.

Flashing the ESP8266

To flash the firmware onto your ESP8266:

chmod +x flash.sh
./flash.sh

Make sure your board is connected to the port you will enter while flashing.

Installation of dependencies and serial monitor

To install the required software components on your laptop:

chmod +x install.sh
./install.sh

This will install all dependencies and system tools needed to interact with the ESP8266 and run the command-line interface.

Usage

To open serial monitor to the connected ESP8266, run the following command

nullswitch

OR

nullswitch <PORT>

The first way will ask for the port to the ESP8266

Uninstallation

To uninstall the software from your laptop:

nullswitch --uninstall

This will remove installed components and clean up the system environment.

Copyright © 2025 Debjeet Banerjee