{"id":23378878,"url":"https://github.com/cifertech/nrfbox","last_synced_at":"2025-04-05T02:04:56.976Z","repository":{"id":136172632,"uuid":"556894297","full_name":"cifertech/nRFBox","owner":"cifertech","description":"All-in-One Gadget for Dominating BLE and 2.4GHz Networks | BLE Jammer - BLE Spoofer - Scanner","archived":false,"fork":false,"pushed_at":"2025-01-20T20:44:24.000Z","size":16837,"stargazers_count":698,"open_issues_count":37,"forks_count":83,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-03-29T01:04:25.488Z","etag":null,"topics":["arduino","ble-jammer","ble-spoof","ble-spoofer","cybersecurity","esp32","hack","hacktoberfest","jammer","nrf-scanner","nrf24l01","sour-apple"],"latest_commit_sha":null,"homepage":"https://youtu.be/UBaRcpUHTkA","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cifertech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-24T18:07:26.000Z","updated_at":"2025-03-28T14:00:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"cd0afb15-f0e5-4dc6-b2ca-4bf397e017a3","html_url":"https://github.com/cifertech/nRFBox","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cifertech%2FnRFBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cifertech%2FnRFBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cifertech%2FnRFBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cifertech%2FnRFBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cifertech","download_url":"https://codeload.github.com/cifertech/nRFBox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247276163,"owners_count":20912288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","ble-jammer","ble-spoof","ble-spoofer","cybersecurity","esp32","hack","hacktoberfest","jammer","nrf-scanner","nrf24l01","sour-apple"],"created_at":"2024-12-21T19:14:58.720Z","updated_at":"2025-04-05T02:04:51.968Z","avatar_url":"https://github.com/cifertech.png","language":"C++","funding_links":["https://www.patreon.com/cifertech"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"https://user-images.githubusercontent.com/62047147/195847997-97553030-3b79-4643-9f2c-1f04bba6b989.png\" alt=\"logo\" width=\"100\" height=\"auto\" /\u003e\n  \n  \u003ch1\u003e nRFBOX \u003c/h1\u003e\n  \u003cp\u003e All-in-One Gadget for BLE and 2.4GHz Networks \u003c/p\u003e\n\n\n\u003c!-- Badges --\u003e\n\u003ca href=\"https://github.com/cifertech/nrfbox\" title=\"Go to GitHub repo\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=cifertech\u0026message=nrfbox\u0026color=purple\u0026logo=github\" alt=\"cifertech - nrfbox\"\u003e\u003c/a\u003e\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/cifertech/nrfbox/total)\n\u003ca href=\"https://github.com/cifertech/nrfbox\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/cifertech/nrfbox?style=social\" alt=\"stars - nrfbox\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/cifertech/nrfbox\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/cifertech/nrfbox?style=social\" alt=\"forks - nrfbox\"\u003e\u003c/a\u003e\n\n   \n\u003ch4\u003e\n    \u003ca href=\"https://twitter.com/techcifer\"\u003eTWITTER\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://www.instagram.com/cifertech/\"\u003eINSTAGRAM\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://www.youtube.com/@techcifer\"\u003eYOUTUBE\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://cifertech.net/\"\u003eWEBSITE\u003c/a\u003e\n  \u003c/h4\u003e\n\u003c/div\u003e\n\u003cbr/\u003e\n\n## 📖 Explore the Full Documentation\n\nReady to dive deeper into nRFBOX's details? Discover the full story, in-depth tutorials, and all the exciting features in our comprehensive [documentation](https://cifertech.net/nrfbox-your-all-in-one-gadget-for-ble-and-2-4ghz-networks/). Click the link and explore further!\n  \n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003ch2\u003e🛠 Functionality Status and Reliability\u003c/h2\u003e\n\n\u003ctable\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth\u003eFeature\u003c/th\u003e\n      \u003cth\u003eStatus\u003c/th\u003e\n      \u003cth\u003eReliability\u003c/th\u003e\n      \u003cth\u003eNotes\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eScanner\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eHigh\u003c/td\u003e\n      \u003ctd\u003eReliably scans the 2.4 GHz band to detect active channels and nearby devices. Occasional misses in high-interference environments.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eAnalyzer\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eHigh\u003c/td\u003e\n      \u003ctd\u003eProvides useful insights into detected signals, but additional updates are needed for improved accuracy and detailed analysis.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eJammer\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eHigh\u003c/td\u003e\n      \u003ctd\u003eBasic jamming works but effectiveness varies by device type and signal strength. Testing on select channels is recommended.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eBLE Jammer\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eHigh\u003c/td\u003e\n      \u003ctd\u003eDisrupts BLE devices inconsistently. Further improvements are needed to ensure stability and effectiveness across BLE variants.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eBLE Spoofer\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eLow\u003c/td\u003e\n      \u003ctd\u003eCapable of simulating basic BLE signals but has limited compatibility. Best for controlled testing scenarios.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cstrong\u003eSour Apple\u003c/strong\u003e\u003c/td\u003e\n      \u003ctd\u003eStable\u003c/td\u003e\n      \u003ctd\u003eLow\u003c/td\u003e\n      \u003ctd\u003eSpecialized attack method with limited reliability; effective only under specific conditions. Further tuning is required.\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n- When using **multiple NRF24** modules, the power demands can exceed the capabilities of the onboard power supply or regulator. Running three NRF modules simultaneously may cause instability, leading to intermittent failures or causing the nRFBox to stop functioning altogether.\n- **Range Limitations**: The jammer is most effective at short range. Beyond a certain distance, the signal weakens, making it harder to consistently disrupt communication.\n- **Device Variability**: Different devices react to jamming signals in varying ways. Some may be more resistant.\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- About the Project --\u003e\n## :star2: About the Project\nnRFBOX is a wireless toolkit designed to explore, analyze, and interact with various wireless communication protocols. It 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.\n\n\n\n\u003cdiv align=\"center\"\u003e \n  \u003cimg src=\"https://github.com/user-attachments/assets/7012353c-2d09-4956-9152-937cf6a7ce18\" alt=\"screenshot\" width=\"Auto\" height=\"Auto\" /\u003e\n\u003c/div\u003e\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- Features --\u003e\n### 🎯 Features\n\n**Software:**\n- **Scanner**: Scans the 2.4GHz frequency band to detect active channels and devices.\n- **Analyzer**: Analyzes the detected signals and provides detailed information about the activity.\n- **Jammer**: Jams wireless communication on selected channels to test network robustness.\n- **BLE Jammer**: Specifically targets Bluetooth Low Energy (BLE) devices to disrupt their communication.\n- **BLE Spoofer**: Spoofs BLE devices to simulate various BLE signals for testing and research.\n- **Sour Apple**: A specialized attack for testing security measures against specific wireless vulnerabilities.\n- **Proto Kill Mode**: Proto Kill has evolved into a powerful tool for disrupting various protocols.\n\n- **WiFi Scanner**\n- **BLE Scanner**\n\n**Hardware:**\n- ESP32 Wroom32U\n- NRF24 GTmini Modules\n- OLED 0.96\" Display\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- nRFBOX V2 --\u003e\n## :eyes: nRFBox Versions: Then and Now\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd style=\"text-align: center;\"\u003e\n      \u003cimg src=\"https://github.com/user-attachments/assets/b121fe84-c789-409a-85f5-21f6d5854347\" alt=\"nRFBOX V1\" style=\"width: 600px; border: 1px solid #ccc; border-radius: 5px;\"\u003e\n      \u003cp style=\"font-style: italic; font-size: 14px; margin-top: 5px;\"\u003enRFBox-v1 based on Arduino\u003c/p\u003e\n    \u003c/td\u003e    \n    \u003ctd style=\"text-align: center;\"\u003e\n      \u003cimg src=\"https://github.com/user-attachments/assets/a044ab5e-346c-415f-b1fb-f65aa04c520a\" alt=\"nRFBOX V2\" style=\"width: 600px; border: 1px solid #ccc; border-radius: 5px;\"\u003e\n      \u003cp style=\"font-style: italic; font-size: 14px; margin-top: 5px;\"\u003enRFBox-v2 based on ESP32\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n## 🔗 Uploading the Firmware (.bin) to ESP32\n\nIf you prefer not to upload the code manually or encounter errors during compilation, you can directly upload the precompiled `.bin` file to the ESP32. Follow these steps:\n\n### Step 1: Download the Required Tools\n1. **ESP32 Flash Download Tool**: Download the tool from Espressif's official site: [ESP32 Flash Download Tool](https://www.espressif.com/sites/default/files/tools/flash_download_tool_3.9.7_2.zip).\n2. **USB Drivers**: Make sure the drivers for the ESP32 are installed on your system. You can download the drivers from [CP210x USB to UART Bridge VCP Drivers](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers) if you're using the CP2102 chip.\n\n### Step 2: Prepare the `.bin` File\n1. Download the [precompiled `.bin`](https://github.com/cifertech/nRFBox/tree/main/precompiled%20%20bin) file from the repository. \n\n### Step 3: Upload the `.bin` File to ESP32\n1. Connect your ESP32 to your computer using a USB cable.\n2. Open the **ESP32 Flash Download Tool** and configure the following:\n   - Select the appropriate **chip type** (ESP32) and click **OK**.\n   - In the **Download Path Config** section, add the `.bin` file and set the start address to `0x10000`.\n   - Select the correct **COM port** where your ESP32 is connected.\n   - Choose the correct **Baud rate** (115200 is generally recommended).\n\n3. Click on **Start** to begin uploading the `.bin` file to your ESP32.\n\n### Step 4: Verify the Upload\nOnce the upload is completed, the tool will confirm a successful flash. You can now restart your ESP32 and run the firmware.\n\n\u0026nbsp;\n### Arduino IDE 1.8 Settings:\nIf you want to upload the sketch code to the ESP32, use the following settings in the Tools menu:\n- **Built using ESP32 Board Version 2.0.11**\n\n\u003cdiv style=\"display: flex; justify-content: center; align-items: center; gap: 10px;\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/2e43dc05-9ef7-4743-85f2-a8fc38e7b785\" alt=\"Photo 1\" style=\"width: 34%; border: 1px solid #ccc; border-radius: 5px;\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/9fc87b96-7442-44f8-9457-22d1b481eda1\" alt=\"Photo 2\" style=\"width: 53%; border: 1px solid #ccc; border-radius: 5px;\"\u003e\n\u003c/div\u003e\n\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- License --\u003e\n## :warning: License\n\nDistributed under the MIT License. See LICENSE.txt for more information.\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- Contact --\u003e\n## :handshake: Contact\n\n▶ Support me on Patreon [patreon.com/cifertech](https://www.patreon.com/cifertech)\n\nCiferTech - [@twitter](https://twitter.com/techcifer) - CiferTech@gmali.com\n\nProject Link: [https://github.com/cifertech/nRFBOX](https://github.com/cifertech/nrfbox)\n\n\u003cdiv\u003e\u0026nbsp;\u003c/div\u003e\n\n\u003c!-- Acknowledgments --\u003e\n## :gem: Acknowledgements \n\n**The libraries and projects listed below are used in this software:**\n - [Poor Man’s 2.4 GHz Scanner](https://forum.arduino.cc/t/poor-mans-2-4-ghz-scanner/54846)\n - [arduino_oled_menu](https://github.com/upiir/arduino_oled_menu)\n - [nRF24L01-WiFi-Jammer](https://github.com/hugorezende/nRF24L01-WiFi-Jammer)\n - [Universal-RC-system](https://github.com/alexbeliaev/Universal-RC-system/tree/master)\n - [AppleJuice](https://github.com/ECTO-1A/AppleJuice)\n - [ESP32-Sour-Apple](https://github.com/RapierXbox/ESP32-Sour-Apple)\n\n**Community Contributors**: Thanks to everyone who helped improve nRFBox! Your support is much appreciated!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcifertech%2Fnrfbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcifertech%2Fnrfbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcifertech%2Fnrfbox/lists"}