All-in-One Gadget for BLE and 2.4GHz Networks
Maintained by jbohack & zr_crackiin
nyanBOX is a fork of the original nRFBOX project by CiferTech, now maintained by jbohack & zr_crackiin. This version includes various improvements and new features while maintaining compatibility with the original hardware.
- Updated UI with improved display layout
- Enhanced stability and performance
- New features and improvements to existing functionality
- Active maintenance and support
nyanBOX is a wireless toolkit designed to explore, analyze, and interact with various wireless communication protocols. Based on the original nRFBOX by CiferTech, this fork retains all the powerful features while introducing new improvements and providing ongoing maintenance.
The device combines the ESP32 Wroom32U, NRF24 modules, an OLED display, and other components to create a multifunctional device that can act as a scanner, analyzer, jammer, BLE jammer, BLE spoofer, and perform advanced tasks such as the "Sour Apple" attack.
- WiFi Scanner – Detects nearby WiFi access points
- Channel Analyzer – Monitors WiFi channel utilization and signal strength for network planning
- WiFi Deauther – Disrupts 2.4GHz WiFi device communication
- Deauth Scanner – Monitors and analyzes WiFi deauthentication frames in real-time
- Beacon Spam – Broadcasts multiple fake WiFi networks for testing. Choose to clone real nearby networks, select specific SSIDs, or use a list of random names.
- Pwnagotchi Detector – Detects nearby Pwnagotchi devices and displays their information
- Pwnagotchi Spam - Pwnagotchi grid flooding tool that generates fake beacon frames with randomized identities, faces, names, and versions (contains optional DoS mode).
- WLAN Jammer – Jams wireless communication on selected channels
- BLE Scanner – Detects nearby BLE devices
- Flipper Scanner – Detects nearby Flipper Zero devices
- BLE Spammer – Broadcasts BLE advertisement packets for testing
- BLE Jammer – Disrupts BLE device communication
- Sour Apple – Mimics Apple Bluetooth signals like AirPods pairing pop-up to test device resilience against protocol exploits.
- BLE Spoofer – Simulates BLE devices for testing and research
- Proto Kill Mode – Advanced tool for disrupting various wireless protocols
- Scanner – Scans the 2.4GHz frequency band to detect active channels and devices
- Analyzer – Analyzes detected signals and provides detailed activity information
- Main Controller: ESP32 Wroom32U
- Wireless Modules: NRF24 GTmini x3
- Display: 0.96" OLED
- Connectivity: USB-C, UART
Install the required USB drivers for your ESP32 board:
- CP210x-based boards: CP210x USB to UART Bridge VCP Drivers
- CH340/CH341-based boards: CH340 Drivers
- Visual Studio Code
- PlatformIO IDE extension
- Clone this repository:
git clone https://github.com/jbohack/nyanBOX.git
- Open the project in VS Code:
- Select
File > Open Folder - Choose the nyanBOX directory
- Select
- Pre-configured for ESP32-DevKitC in
platformio.ini - For other ESP32 boards, update the
boardparameter inplatformio.ini
- Build: Click the checkmark icon in the status bar
- Connect: Plug in your ESP32 via USB
- Upload: Click the right-arrow icon
- Monitor: Click the plug icon to open the serial monitor
- Upload Failing? Try holding the BOOT button during upload
- Connection Issues? Verify the correct COM port is selected
- Driver Problems? Ensure proper USB drivers are installed (see Prerequisites)
This project is provided for educational and authorized security research purposes only.
The creators and maintainers of nyanBOX disclaim all responsibility for any unauthorized or unlawful use of this software or hardware.
It is the sole responsibility of the user to ensure compliance with all applicable local, state, federal, and international laws.
- Unauthorized scanning, jamming, or interference with wireless communications may be illegal in your jurisdiction.
- Always obtain explicit permission before testing on networks or devices you do not own.
- Certain features may be restricted or prohibited in some countries or regions.
- The developers assume no liability for any damages, legal consequences, or misuse resulting from this project.
By using nyanBOX, you agree to use it only for lawful, ethical, and educational purposes, and acknowledge your responsibility to remain informed about and compliant with all relevant laws and regulations.
Distributed under the MIT License. See LICENSE for more information.
If you find nyanBox useful, please consider supporting the project:
- Poor Man's 2.4 GHz Scanner
- arduino_oled_menu
- nRF24L01-WiFi-Jammer
- Universal-RC-system
- AppleJuice
- ESP32-Sour-Apple
- PwnGridSpam
- Original nRFBOX Project
A big thank you to all contributors and community members who have helped improve nyanBOX!
#BadgeLife