NRSuite Documentation¶

Official guides, setup instructions, troubleshooting, protocol references, and downloadable example resources for the NRSuite Android app and ESP32 firmware.

Authorized testing only

Use NRSuite only on networks, devices, and accessories you own or have explicit written permission to test. Active Wi-Fi, BLE, WPS, deauthentication, capture, portal, IR, BadUSB, and flashing features are intended for authorized security research and testing.

Start here¶

I want to...	Go to
Install the Android app	Android installation
Check if my board is supported	Supported boards
Flash the ESP32 firmware	Firmware flashing
Learn the app workflows	Android usage guide
Set up the Termux SSH terminal	Terminal guide
Download example files	Resources and downloads
Read the wire protocol	Protocol overview

Current release line¶

Android:  1.0.0-beta.3.2.0
Firmware: 1.0.0-beta.3.2.0
Protocol: 1.0 / proto_minor 2, non-mesh

The firmware supports classic ESP32, ESP32-C3, ESP32-C5, ESP32-S2, and ESP32-S3 boards, including common devkits and compact SuperMini, Mini, and Nano variants. Match the target by MCU family and PSRAM configuration.

ESP32-C5 boards can have different available heap and largest-block values. Memory-heavy features such as BLE HID may pass on one C5 variant and be rejected on another. Check live device telemetry before starting them.

Download the matching builds from GitHub Releases:

Screenshots¶

Home	WiFi Recon	Terminal

Firmware Flasher	Themes

Project repositories¶

Repository	Contents
NRSuite-Android	Android companion app
NRSuite-firmware	ESP32 firmware
NRSuite-Protocol	Wire protocol specification
NRSuite-Docs	This documentation and resource site