Thanks to visit codestin.com
Credit goes to github.com

Skip to content
forked from jbohack/nyanBOX

A compact ESP32 Wroom32U toolkit for wireless security—scan, analyze, jam, and spoof RF, Wi-Fi, and BLE protocols, all from a simple menu-driven interface.

License

Notifications You must be signed in to change notification settings

tototo31/nyanBOX

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

nyanBOX

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

By Nyan Devices | Maintained by jbohack & zr_crackiin

nyanBOX - jbohack stars - nyanBOX forks - nyanBOX


What is nyanBOX?

nyanBOX is your pocket-sized 2.4GHz wireless lab. Think of it as a swiss army knife for the entire 2.4GHz spectrum - Bluetooth, BLE, WiFi, and everything in between. Perfect for security researchers, pentesters, hackers, and curious tinkerers who want to understand how wireless protocols really work.

Built around an ESP32 with triple NRF24 modules, a crisp OLED display, and a 2500mAh rechargeable battery, nyanBOX lets you explore the invisible world of 2.4GHz radio anywhere - no cables needed. Scan for hidden Bluetooth devices, detect AirTags tracking you, find credit card skimmers, analyze RF signals, test wireless security, and way more.

Check out all the features at nyandevices.com

nyanBOX Interface

⚡ Why You'll Love It

  • Plug & Play – USB-C powered, works right out of the box
  • All-Day Battery – 2500mAh battery provides up to a full day of portable use
  • Level Up System – Built-in RPG mechanics track your progress as you explore wireless protocols
  • Open Source – Fully customizable firmware with active community development
  • Complete 2.4GHz Toolkit – 20+ built-in features for Bluetooth, BLE, WiFi, and RF analysis
  • Pocket-Sized – Take it anywhere, scan everything
  • Active Updates – New features added regularly by the community

Ready to dive in? Purchase nyanBOX at shop.nyandevices.com


🎯 What Can It Do?

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

📶 WiFi Tools

  • 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).

🔵 Bluetooth (BLE) Tools

  • 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

📡 Signal & Protocol Tools

  • Flock Detector - Detects Flock Safety surveillance cameras using dual-mode WiFi and BLE scanning. Identifies devices through SSID patterns, MAC OUI prefixes, and Bluetooth device names. Features real-time signal strength tracking with detailed device info and a locate mode for pinpointing camera positions.
  • Scanner – Scans the 2.4GHz frequency band to detect active channels and devices
  • Analyzer – Analyzes detected signals and provides detailed activity information

🎮 Leveling System

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!


🛠️ Hardware Specs

Component Details
Microcontroller ESP32 WROOM‑32U (dual‑core, Wi‑Fi + BT)
Wireless Modules 3× NRF24 GTmini modules
Display 0.96" OLED
Power USB‑C + 2500mAh rechargeable battery
Battery Up to a full day typical use
Case Protective enclosure included
Debug UART

Get yours: https://shop.nyandevices.com


🚀 Getting Started

First Time Setup

Purchase a nyanBOX from shop.nyandevices.com and flash the firmware in minutes using our web-based flasher!

Firmware Installation & Updates

Get up and running or update to the latest features:

Easy Mode - Web Flasher (Recommended)

  1. Head to nyandevices.com/flasher
  2. Plug in your nyanBOX via USB-C
  3. Click Install nyanBOX Firmware
  4. Done!

Advanced - PlatformIO

For developers who want to build from source or customize the firmware:

  1. Install VS Code and PlatformIO
  2. Clone or download this repo
  3. Open the folder in VS Code
  4. Hit Upload in PlatformIO
  5. Flash complete!

Troubleshooting:

  • Can't find the port? Install CP210x drivers
  • Upload failing? Hold the BOOT button while flashing
  • Still stuck? Hit up our Discord - we're here to help!

⚠️ Legal Disclaimer

Use nyanBOX responsibly. It's built for education, security research, and authorized testing only.

  • Don’t attack networks you don’t own
  • Always obtain permission before testing
  • Know your local laws; some features may be restricted
  • You’re responsible for how you use it

By using nyanBOX, you agree to use it ethically and legally. We're not liable for misuse.


❓ FAQ

Is nyanBOX legal to own?
Yes, but some features may be restricted depending on your location and use. Follow local laws and obtain permission.

How long does the battery last?
Up to a full day of typical use. Heavy continuous scanning may reduce runtime; lighter intermittent use can extend it.

Can I develop my own tools?
Yes. The firmware is open source. You can customize and add features. Join our Discord if you need help.

Does it come with firmware pre‑installed?
nyanBOX ships ready to flash. Use the web flasher at https://nyandevices.com/flasher to get running in minutes.


💬 Join the Community

Got questions? Want to show off your device? Need help?


💝 Support the Project

Love nyanBOX? Here's how you can help:

Built By


🙏 Thanks To

And thanks to everyone who's contributed code, reported bugs, purchased a device, or just shared the love. You're awesome!


📜 License

MIT License - see LICENSE for details.


Ready to explore the 2.4GHz spectrum?

🛒 Buy nyanBOX Now

#BadgeLife

About

A compact ESP32 Wroom32U toolkit for wireless security—scan, analyze, jam, and spoof RF, Wi-Fi, and BLE protocols, all from a simple menu-driven interface.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 79.0%
  • C 18.6%
  • Python 2.1%
  • Shell 0.3%