nyanBOX

All-in-One Gadget for BLE and 2.4GHz Networks

Maintained by jbohack & zr_crackiin

Website · Shop · Discord

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 for WiFi and Bluetooth security research, network analysis, RF signal monitoring, and wireless protocol testing.

⚠️ Note: Additional advanced applications can be enabled in the Settings menu.

• 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.
• Evil Portal – Creates captive portal with multiple templates (Generic, Facebook, Google) that automatically scans nearby networks for realistic SSID spoofing and credential capture.
• 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).

• BLE Scanner – Detects nearby BLE devices
• nyanBOX Detector – Discovers nearby nyanBOX devices and displays their information including level, version, and signal strength.
• Flipper Scanner – Detects nearby Flipper Zero devices
• Axon Detector – Detects nearby Axon devices (body cameras, tasers, and other law enforcement equipment)
• Skimmer Detector – Detects HC-03, HC-05, and HC-06 Bluetooth modules commonly used in credit card skimming devices.
• AirTag Detector – Scans for and identifies nearby Apple AirTag devices.
• AirTag Spoofer – Clones and rebroadcasts detected Apple AirTag devices for selective or bulk spoofing.
• BLE Spammer – Broadcasts BLE advertisement packets for testing
• 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

• Scanner – Scans the 2.4GHz frequency band to detect active channels and devices
• Analyzer – Analyzes detected signals and provides detailed activity information

nyanBOX features a built-in RPG-style leveling system that tracks your usage throughout using the device:

• Level Progression – Gain XP by using different tools and features
• Rank System – Progress through 9 different ranks
• Usage Tracking – Different XP rates for scanning, attacks, and utilities/misc
• Session Bonuses – Extra XP for extended tool usage
• Level Display – Current level shown on main menu, detailed stats accessible via RIGHT arrow
• Progress Persistence – Level data saved to EEPROM, survives power cycles
• XP Reset – Reset progress via Settings menu if desired
• Device Networking – Your level and version are automatically broadcasted to nearby nyanBOX devices for discovery

Hit RIGHT in the main menu to check your stats. Level up by tinkering with RF signals and unlock ranks as you progress. Other nyanBOX users can see your progress when they scan for nearby devices!

• Main Controller: ESP32 Wroom32U
• Wireless Modules: NRF24 GTmini x3
• Display: 0.96" OLED
• Connectivity: USB-C, UART

For nyanBOX devices purchased from shop.nyandevices.com, please follow the official flashing process:

Install the USB drivers for your operating system:

Windows:

• Download and install CP210x USB to UART Bridge VCP Drivers

macOS:

• Drivers are usually included with macOS. If you experience issues, install the CP210x drivers above.

Linux:

• Most distributions include the drivers by default. If needed, install cp210x kernel module.

1. Visit nyandevices.com/flasher
2. Power off your nyanBOX device and connect it via USB-C
3. Select your serial port and click Install nyanBOX Firmware
4. Wait for the flashing process to complete

• Note: If flashing fails, please view the troubleshooting instructions on the Web Flasher

1. Install PlatformIO & Visual Studio Code

   • Download and install Visual Studio Code
   • Install the PlatformIO IDE extension

2. Get the Firmware

   • Download this repository from GitHub (click the green "Code" button, then "Download ZIP")
   • Extract the ZIP file to a folder on your computer
   • Open VS Code and select File > Open Folder
   • Choose the extracted nyanBOX folder (specifically the folder with the platformio.ini file)

3. Flash Your Device

   • Connect your nyanBOX via a data transfer USB-C cable

   • In VS Code with PlatformIO:

     • Click the PlatformIO icon in the sidebar
     • Select the nyanbox-main environment for normal firmware flashing
     • Select "Upload" (or click the right-arrow → icon in the status bar)

   • The firmware will automatically build and flash to your device

   • Note: If you have multiple serial devices connected, you may need to modify the platformio.ini file to specify upload_port = portName (e.g., upload_port = COM3 on Windows or upload_port = /dev/ttyUSB0 on Linux)

   • Can't find COM port? Check Device Manager (Windows) or ls /dev/tty* (Linux/macOS)

   • Upload failing? Try holding the BOOT button during the flash process

   • Still having issues? Join our Discord for support

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, signal manipulation, 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:

• jbohack's Ko-fi
• zr_crackiin's Ko-fi

• jbohack
• zr_crackiin

• Poor Man's 2.4 GHz Scanner
• arduino_oled_menu
• nRF24L01-WiFi-Jammer
• Universal-RC-system
• AppleJuice
• ESP32-Sour-Apple
• PwnGridSpam
• ESP32-AirTag-Scanner
• ESP Web Tools
• Original nRFBOX Project

A big thank you to all contributors and community members who have helped improve nyanBOX!

#BadgeLife