Audit wireless networks directly via USB hardware across operating systems
Plug a USB wireless card into your laptop and scan or analyze nearby networks immediately, without complex driver installation. The tool bypasses the operating system's built-in wireless stack, using a lightweight Python driver to control the USB device directly. This allows for wireless security audits in the same environment on Linux, Windows, and macOS.
Direct device control without kernel drivers
The tool does not use the standard wireless drivers provided by the operating system. Instead, lightweight code ported from Linux kernel drivers to Python manipulates hardware registers directly through the USB bus and control transfers. This approach avoids restrictions such as Windows NDS limitations or Linux kernel driver locking issues. As a result, low-level operations like monitor mode and frame injection are performed in user space.
Features ranging from reconnaissance to attacks
The tool provides various features for network reconnaissance and security vulnerability analysis. It collects packets using multiple USB cards simultaneously, automatically switches channels in the 2.4GHz and 5GHz bands, and tracks signal strength and encryption methods. It can identify hidden networks, capture WPA/WPA2 handshakes, or obtain PMKID key material. It also supports various attack scenarios, including WPA3 downgrade attacks, WPS PIN recovery, and WEP key recovery.
Supported hardware and installation methods
Using this tool requires specific USB wireless adapters equipped with Atheros, MediaTek, Realtek, or Ralink chipsets. The README lists supported models from various manufacturers, including ALFA, TP-Link, Netgear, and ASUS. There are three installation methods: downloading the executable from the release page, running from source using uv, or building the binary directly. On first run, it requests privilege escalation depending on the operating system to automatically handle necessary driver configurations.
Items to verify before use
Because the tool manipulates USB hardware registers directly, it operates without kernel safety mechanisms. Therefore, malfunction may affect the hardware, and users must take responsibility for this. Additionally, the tool must only be used on networks and equipment that you own or for which you have explicit audit approval. You must verify that you have a supported USB adapter and ensure the hardware is included in the list before use.
