@@ -41,23 +41,23 @@ Built around an ESP32 with triple NRF24 modules, a crisp OLED display, and a 250
---
-## โก Why You'll Love It
+## โก Key Advantages
-- **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
+- **Plug & Play Operation** โ USB-C powered and ready for immediate use
+- **Extended Battery Life** โ 2500mAh battery supports up to a full day of typical operation
+- **Progress Monitoring System** โ Integrated leveling system providing usage insights
+- **Open-Source Firmware** โ Fully customizable with active community contributions
+- **Comprehensive 2.4GHz Suite** โ Over 20 integrated tools for BLE, Bluetooth, Wi-Fi, and RF diagnostics
+- **Portable Design** โ Compact form factor optimized for field work
+- **Regular Updates** โ Ongoing feature additions and improvements
-**Ready to dive in? [Purchase nyanBOX at shop.nyandevices.com](https://shop.nyandevices.com)**
+**Interested? [Purchase nyanBOX at shop.nyandevices.com](https://shop.nyandevices.com)**
---
-## ๐ฏ What Can It Do?
+## ๐ฏ Features & Capabilities
-> **โ ๏ธ Note:** Additional advanced tools can be enabled in the Settings menu.
+> **โ ๏ธ Note:** Some advanced tools may require activation through the Settings menu.
### ๐ถ WiFi Tools
- **WiFi Scanner** โ Detects nearby WiFi access points with full client detection. View connected clients for each network, monitor their signal strength, packet activity, and deauthenticate individual clients.
@@ -93,119 +93,118 @@ Built around an ESP32 with triple NRF24 modules, a crisp OLED display, and a 250
- **Scanner** โ Scans the 2.4GHz frequency band to detect active channels and devices
- **Analyzer** โ Real-time spectrum analyzer with channel filters for targeted RF analysis. Features dynamic display with auto-scaling, peak frequency detection, and instant filter switching via left/right buttons. Analyze WiFi, Bluetooth, or custom frequency bands.
-### ๐ฎ Leveling System
-nyanBOX features a built-in RPG-style leveling system that tracks your usage throughout using the device:
+---
+
+## ๐ฎ Leveling System
+
+The integrated leveling system offers structured, persistent feedback on device usage:
-- **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
+- **Progress Tracking** โ XP earned by using various tool categories
+- **Rank Advancement** โ Nine rank tiers available
+- **Usage Analysis** โ Tools award XP at varying rates
+- **Session Bonuses** โ Extended use yields additional progression
+- **Persistent Storage** โ Data stored in EEPROM across power cycles
+- **Reset Option** โ Users may reset progress via the Settings menu
+- **Device Networking** โ Level and version broadcast for discovery by other nyanBOX units
-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!
+Access detailed statistics via the RIGHT directional button in the main menu.
---
-## ๐ ๏ธ Hardware Specs
+## ๐ ๏ธ Hardware Specifications
-| 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 |
+| Component | Details |
+|-----------------:|----------------------------------------------|
+| Microcontroller | ESP32 WROOM-32U (dual-core, Wi-Fi + BLE) |
+| Wireless Modules | 3ร NRF24 GTmini modules |
+| Display | 0.96" OLED |
+| Power | USB-C + 2500mAh rechargeable battery |
+| Battery Life | Up to one full day of typical usage |
+| Case | Protective enclosure included |
+| Debug Interface | UART |
-Get yours: https://shop.nyandevices.com
+Purchase: https://shop.nyandevices.com
---
## ๐ Getting Started
-### First Time Setup
+### First-Time Setup
-Purchase a nyanBOX from **[shop.nyandevices.com](https://shop.nyandevices.com)** and flash the firmware in minutes using our web-based flasher!
+Purchase a nyanBOX from **[shop.nyandevices.com](https://shop.nyandevices.com)** and install firmware within minutes using the web-based flashing tool.
### Firmware Installation & Updates
-Get up and running or update to the latest features:
+#### Recommended: Web Flasher
+1. Visit **[nyandevices.com/flasher](https://nyandevices.com/flasher)**
+2. Connect the device via USB-C
+3. Select **Install nyanBOX Firmware**
+4. The installation completes automatically
-#### Easy Mode - Web Flasher (Recommended)
-1. Head to **[nyandevices.com/flasher](https://nyandevices.com/flasher)**
-2. Plug in your nyanBOX via USB-C
-3. Click **Install nyanBOX Firmware**
-4. Done!
+#### Advanced: PlatformIO
+1. Install [VS Code](https://code.visualstudio.com/) and [PlatformIO](https://platformio.org/install/ide?install=vscode)
+2. Clone or download the repository
+3. Open the project in VS Code
+4. Select Upload in PlatformIO
+5. The device will flash and restart
-#### Advanced - PlatformIO
-For developers who want to build from source or customize the firmware:
-
-1. Install [VS Code](https://code.visualstudio.com/) and [PlatformIO](https://platformio.org/install/ide?install=vscode)
-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](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
-- Upload failing? Hold the BOOT button while flashing
-- Still stuck? Hit up our [Discord](https://discord.gg/J5A3zDC2y8) - we're here to help!
+**Troubleshooting:**
+- Port unavailable: install [CP210x drivers](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
+- Upload failure: hold the BOOT button during flashing
+- Need assistance? Join the [Discord community](https://discord.gg/J5A3zDC2y8)
---
## โ ๏ธ Legal Disclaimer
-**Use nyanBOX responsibly.** It's built for education, security research, and authorized testing only.
+**Use nyanBOX responsibly and ethically.**
+It is designed strictly for authorized testing, research, and educational purposes.
-- 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
+- Do not perform unauthorized network attacks
+- Obtain explicit permission prior to conducting assessments
+- Comply with all applicable local laws and regulations
+- Users are fully responsible for their actions
-By using nyanBOX, you agree to use it ethically and legally. We're not liable for misuse.
+By using nyanBOX, you agree to adhere to lawful and ethical usage practices.
---
## โ 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.
+Yes. Ownership is legal, though specific features may be subject to local restrictions.
**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.
+Up to one full day during typical operation. Continuous intensive scanning may reduce runtime.
**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.
+Yes. The firmware is open source and supports extensive customization.
-**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.
+**Does it come with firmware pre-installed?**
+Devices ship ready for flashing. The web flasher enables installation in minutes.
---
## ๐ฌ Join the Community
-Got questions? Want to show off your device? Need help?
+Have questions or need assistance?
-- **[Discord](https://discord.gg/J5A3zDC2y8)** - Most active community spot
-- **[GitHub Issues](https://github.com/jbohack/nyanBOX/issues)** - Report bugs or request features
-- **[nyandevices.com](https://nyandevices.com)** - Full docs and guides
+- **[Discord](https://discord.gg/J5A3zDC2y8)** โ Primary community hub
+- **[GitHub Issues](https://github.com/jbohack/nyanBOX/issues)** โ Bug reports and feature requests
+- **[nyandevices.com](https://nyandevices.com)** โ Documentation and guides
---
## ๐ Support the Project
-Love nyanBOX? Here's how you can help:
+If you find nyanBOX valuable, consider supporting development:
-- โญ Star this repo
-- ๐ **[Buy nyanBOX at shop.nyandevices.com](https://shop.nyandevices.com)**
-- โ Buy us a coffee:
- - [jbohack's Ko-fi](https://ko-fi.com/jbohack)
- - [zr_crackiin's Ko-fi](https://ko-fi.com/zrcrackiin)
-- ๐ฃ๏ธ Spread the word!
+- โญ Star this repository
+- ๐ **[Purchase at shop.nyandevices.com](https://shop.nyandevices.com)**
+- โ Support the developers:
+ - [jbohack on Ko-fi](https://ko-fi.com/jbohack)
+ - [zr_crackiin on Ko-fi](https://ko-fi.com/zrcrackiin)
+- ๐ฃ๏ธ Share with others interested in wireless research
### Built By
- [jbohack](https://github.com/jbohack)
@@ -228,20 +227,20 @@ Love nyanBOX? Here's how you can help:
- [Flock You](https://github.com/colonelpanichacks/flock-you)
- [Original nRFBOX Project](https://github.com/cifertech/nrfbox)
-And thanks to everyone who's contributed code, reported bugs, purchased a device, or just shared the love. You're awesome!
+Thank you to all contributors, testers, supporters, and community members.
---
## ๐ License
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License โ see [LICENSE](LICENSE) for details.
---
\ No newline at end of file
+