# โก N3XUS
### *The Ultimate Electronic Warfare Toolkit*
**"Security is not a product, but a process."** โ *Bruce Schneier*
---
## ๐จ IMPORTANT LEGAL NOTICE
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ THIS TOOL IS PROVIDED FOR EDUCATIONAL AND RESEARCH PURPOSES โ
โ ONLY. THE AUTHOR DOES NOT CONDONE OR SUPPORT ANY ILLEGAL โ
โ USE OF THIS TECHNOLOGY. USING THIS TOOL AGAINST NETWORKS OR โ
โ DEVICES WITHOUT EXPLICIT PERMISSION IS ILLEGAL AND MAY โ
โ RESULT IN SEVERE PENALTIES UNDER LOCAL AND INTERNATIONAL โ
โ LAWS. BY USING THIS TOOL, YOU AGREE TO TAKE FULL โ
โ RESPONSIBILITY FOR YOUR ACTIONS. โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
text
---
## ๐ก What is N3XUS?
**N3XUS** is a state-of-the-art, portable **Electronic Warfare (EW) testing toolkit** built around the powerful ESP32 microcontroller. It integrates **three NRF24L01+ PA+LNA modules** for 2.4GHz operations and a **CC1101 transceiver** for sub-1GHz frequency bands, creating a comprehensive platform for:
- ๐ **RF Reconnaissance** โ Full-spectrum scanning and signal analysis
- โ๏ธ **Attack Simulation** โ Deauthentication attacks, packet injection, and frequency jamming
- ๐ญ **Deception Techniques** โ Rogue AP creation, MAC spoofing, and device manipulation
- ๐ก๏ธ **Network Security Testing** โ WPA/WPA2 handshake capture and PMKID analysis
- ๐ **Real-time Visualization** โ TFT display with live status and statistics
- ๐ **Remote Control** โ Web-based dashboard accessible via WiFi
---
## ๐ฏ Why N3XUS?
| Feature | N3XUS | Flipper Zero | HackRF | RTL-SDR |
|---------|-------|--------------|--------|---------|
| **Cost** | ~$50 | ~$200 | ~$400 | ~$30 |
| **Frequency Bands** | 2.4GHz + Sub-1GHz | Sub-1GHz + RFID | 1MHz-6GHz | 24MHz-1.7GHz |
| **Transmit Capability** | โ
Yes | โ
(Limited) | โ
Yes | โ No |
| **3x NRF24 Modules** | โ
Simultaneous | โ No | โ No | โ No |
| **Web Panel Control** | โ
Built-in | โ No | โ No | โ No |
| **TFT Display** | โ
1.69" Color | โ No | โ No | โ No |
| **SD Card Logging** | โ
Included | โ
Included | โ No | โ No |
| **12 Operational Modes** | โ
Comprehensive | โ
Limited | โ No | โ No |
| **Open Source** | โ
MIT License | โ Closed | โ
Partially | โ
GNU |
| **Educational Value** | โญโญโญโญโญ | โญโญโญโญ | โญโญโญ | โญโญโญ |
---
## ๐ Quick Start
```bash
# 1. Clone the repository
git clone https://github.com/here-is-leo/N3XUS.git
# 2. Navigate to the project
cd N3XUS
# 3. Open the firmware in Arduino IDE
# File โ Open โ firmware/N3XUS_V7.1.ino
# 4. Install required libraries (see below)
# 5. Upload to ESP32
# Tools โ Board โ ESP32 Dev Module
# Tools โ Port โ Select your COM port
# Click Upload
# 6. Connect to the device
# WiFi: N3XUS (password: 12345678)
# Web Panel: http://192.168.4.1
๐ฆ Hardware Requirements
Essential Components
Component Quantity Specifications Estimated Price (USD) Estimated Price (IRR)
ESP32 Development Board 1 38-pin, WROOM-32, 4MB Flash $8-12 150,000-300,000
NRF24+PA+LNA 3 2.4GHz, with external antenna $10-15 each 250,000-400,000
CC1101 Transceiver 1 Sub-1GHz, with antenna $8-12 200,000-350,000
TFT Display 1.69" 1 ST7789 driver, 240x280 $12-18 300,000-500,000
OLED 0.96" 1 I2C, SSD1306 (optional) $3-5 80,000-150,000
SD Card Reader 1 SPI interface $2-4 50,000-100,000
Micro SD Card 1 4-32GB, FAT32 format $5-10 100,000-200,000
AMS1117 3.3V Regulator 1 With heatsink $2-3 50,000-80,000
Capacitors Several 10ยตF, 100ยตF, 22ยตF $2-5 50,000-100,000
LEDs (5 colors) 5 With 220ฮฉ resistors $3-5 80,000-150,000
Push Buttons 3 Tactile switches $2-3 50,000-80,000
Breadboards 2+ Large + mini $10-15 250,000-400,000
Jumper Wires Set Male-to-male, male-to-female $5-10 100,000-200,000
5V 2A Power Supply 1 USB charger or power bank $10-15 250,000-400,000
Optional Components
Component Description Estimated Price
18650 Li-ion Battery For portable operation $5-10
TP4056 Charger Module For battery charging $2-3
Boost Converter 3.7V to 5V step-up $2-4
Enclosure/Case 3D printed or project box $10-20
External Antennas For improved range $5-15 each
Total Estimated Cost: $80-120 (1,500,000 - 2,500,000 IRR)
๐ Pinout Diagram
ESP32 30-Pin Pinout
text
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ESP32-WROOM-32 (30-Pin) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ GND โโโโโ โโโโ 3.3V โ
โ GPIO23 โโโผโโโโ MOSI (SPI) โผโโโ GPIO22 โ
โ GPIO22 โโโค โโโโ GPIO21 โ
โ GPIO1 โโโโค โโโโ GPIO19 โโ MISO
โ GPIO3 โโโโค โโโโ GPIO18 โโ SCK
โ GPIO21 โโโค โโโโ GPIO5 โโ RST (TFT)
โ GPIO19 โโโผโโโโ MISO (SPI) โผโโโ GPIO17 โโ GDO0 (CC1101)
โ GPIO18 โโโผโโโโ SCK (SPI) โผโโโ GPIO16 โโ DC (TFT) / CS (CC1101)
โ GPIO5 โโโโผโโโโ RST (TFT) โผโโโ GPIO4 โโ SW3 (Button)
โ GPIO17 โโโผโโโโ GDO0 (CC1101) โผโโโ GPIO0 โโ (BOOT Button)
โ GPIO16 โโโผโโโโ DC (TFT) / CS (CC1101) โผโโโ GPIO2 โโ CS (TFT)
โ GPIO4 โโโโผโโโโ SW3 (Button) โผโโโ GPIO15 โโ LED_WHITE
โ GPIO0 โโโโผโโโโ (BOOT Button) โผโโโ GPIO13 โโ LED_RED
โ GPIO2 โโโโผโโโโ CS (TFT) โผโโโ GPIO12 โโ LED_GREEN
โ GPIO15 โโโผโโโโ LED_WHITE โผโโโ GPIO14 โโ CS (SD Card)
โ GPIO13 โโโผโโโโ LED_RED โผโโโ GPIO27 โโ LED_YELLOW
โ GPIO12 โโโผโโโโ LED_GREEN โผโโโ GPIO26 โโ CSN (NRF1)
โ GPIO14 โโโผโโโโ CS (SD Card) โผโโโ GND โ
โ GPIO27 โโโผโโโโ LED_YELLOW โผโโโ 3.3V โ
โ GPIO26 โโโผโโโโ CSN (NRF1) โผโโโ EN โโ Reset
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Component Connections Table
Component Pin ESP32 Description
SPI Bus SCK GPIO 18 Shared Clock
MOSI GPIO 23 Shared Data Out
MISO GPIO 19 Shared Data In
TFT CS GPIO 2 Chip Select
DC GPIO 16 Data/Command
RST GPIO 5 Reset
BLK 3.3V Backlight
NRF1 (Assassin) CE GPIO 25 Chip Enable
CSN GPIO 26 Chip Select
NRF2 (Watcher) CE GPIO 32 Chip Enable
CSN GPIO 33 Chip Select
NRF3 (Ghost) CE GPIO 22 Chip Enable
CSN GPIO 21 Chip Select
CC1101 CS GPIO 16 Chip Select
GDO0 GPIO 17 GPIO/Interrupt
SD Card CS GPIO 14 Chip Select
LEDs Green GPIO 12 System Ready
Red GPIO 13 Alert/Attack
Yellow GPIO 27 Scanning
White GPIO 15 Standby
Blue GPIO 34 SD Activity
Buttons SW1 GPIO 33 Menu/Back
SW2 GPIO 32 Up/Select
SW3 GPIO 4 Down/Back
๐ฎ 12 Operational Modes
๐ก Reconnaissance (Scanning & Discovery)
# Mode Icon Description Use Case
1 Omniscient ๐ก Full 125-channel scan (2.4GHz + sub-1GHz) Discover all devices in range
2 Shadow ๐ค Stealth scan (receive-only, no transmission) Undetectable reconnaissance
3 Spectrum Analyzer ๐ Real-time signal strength visualization RF environment analysis
4 Device Finder ๐ฏ Targeted device discovery (cameras, drones) Locate specific devices
โ๏ธ Attack (Offensive Operations)
# Mode Icon Description Use Case
5 Annihilator ๐ฅ Multi-channel attack on all networks Widespread disruption
6 Sniper ๐ฏ Targeted attack on a specific channel Precision strikes
7 Blackout ๐ Full frequency jamming across all channels Complete signal blackout
8 Zombie ๐ง Packet injection into target networks Confuse security systems
๐ญ Deception (Social Engineering)
# Mode Icon Description Use Case
9 Mirage ๐ญ Rogue AP creation Phishing and man-in-the-middle
10 Chameleon ๐ฆ MAC address spoofing Hide identity in networks
11 Puppet ๐ช IoT device control Manipulate smart devices
๐ Hybrid (Combined Operations)
# Mode Icon Description Use Case
12 Omega ๐ Combined mode (Scan+Attack+Inject) Advanced operations
๐ฅ๏ธ Web Panel Features
Dashboard Overview
text
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โก N3XUS v7.1 โ ONLINE โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ ๐ก Mode: Omniscient ๐ Networks: 12 โ โ
โ โ ๐ Status: ACTIVE ๐ค Packets: 1,247 โ โ
โ โ โฑ๏ธ Uptime: 02:34:17 ๐ Last Result: Scan OK โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โ [โถ ACTIVATE] [๐ SCAN] [โก ATTACK] โ
โ โ
โ [โ PREV] [NEXT โถ] โ
โ โ
โ Select Mode: [Omniscient โพ] โ
โ โ
โ โ System ready โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ N3XUS v7.1 ยท 12 Modes ยท 3x NRF โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Web Panel Capabilities
Feature Description
Real-time status monitoring Live system state (ONLINE/OFFLINE)
Mode selection and execution Choose from 12 modes with one click
Live packet statistics Track packets sent/received in real-time
Network discovery results View detected networks and signal strength
Command execution interface Run scans, attacks, and operations
Mobile-responsive design Works on phones, tablets, and desktops
Auto-refresh every 2 seconds Always up-to-date information
Dark theme Eye-friendly design for extended use
๐ Step-by-Step Setup Guide
1๏ธโฃ Install Arduino IDE
bash
# Windows/Mac/Linux
# Download from: https://www.arduino.cc/en/software
# Install version 1.8.19 or newer
# Follow installation wizard for your OS
Detailed Installation Steps:
Windows:
Download the Windows installer (.exe)
Run the installer
Follow the wizard, accept the license
Choose installation directory (default: C:\Program Files (x86)\Arduino)
Select "Install USB drivers" option
Complete installation
Mac:
Download the Mac version (.dmg)
Open the .dmg file
Drag Arduino.app to Applications folder
Open Arduino from Applications
Linux:
bash
# Ubuntu/Debian
sudo apt update
sudo apt install arduino
# Or download the Linux AppImage from the website
chmod +x arduino-*.AppImage
./arduino-*.AppImage
2๏ธโฃ Add ESP32 Board Support
bash
# Open Arduino IDE โ File โ Preferences
# Add to "Additional Boards Manager URLs":
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
# Click OK to save
# Tools โ Board โ Boards Manager
# Search "ESP32"
# Install "esp32 by Espressif Systems"
# Wait for installation to complete
3๏ธโฃ Install Required Libraries
bash
# Sketch โ Include Library โ Manage Libraries
# Search and install each library:
Essential Libraries:
Library Author Search Term Purpose
TFT_eSPI Bodmer TFT_eSPI TFT display driver
RF24 TMRh20 RF24 NRF24 communication
ELECHOUSE_CC1101 ELECHOUSE ELECHOUSE_CC1101 CC1101 communication
SD Built-in SD (built-in) SD card interface
SPI Built-in SPI (built-in) SPI communication
WiFi Built-in WiFi (built-in) WiFi connectivity
WebServer Built-in WebServer (built-in) Web server
Installation Instructions:
Click on the library name
Click "Install" button
Wait for download and installation
Repeat for each library
4๏ธโฃ Configure TFT_eSPI Library
bash
# Navigate to: libraries/TFT_eSPI/User_Setup.h
# Open in a text editor
# Enable/configure these lines:
Required Configuration:
cpp
// ==========================================
// DISPLAY DRIVER
// ==========================================
#define ST7789_DRIVER // Enable ST7789 driver
// ==========================================
// DISPLAY RESOLUTION
// ==========================================
#define TFT_WIDTH 240 // Display width
#define TFT_HEIGHT 280 // Display height
// ==========================================
// PIN CONFIGURATION
// ==========================================
#define TFT_CS 2 // Chip select pin
#define TFT_DC 16 // Data/Command pin
#define TFT_RST 5 // Reset pin
#define TFT_SCLK 18 // SPI Clock
#define TFT_MOSI 23 // SPI Data Out
#define TFT_MISO 19 // SPI Data In
// ==========================================
// BACKLIGHT
// ==========================================
#define TFT_BACKLIGHT_ON HIGH // Backlight active high
// ==========================================
// FONTS
// ==========================================
#define LOAD_GLCD // Load GLCD font
#define LOAD_FONT2 // Load Font2
#define LOAD_FONT4 // Load Font4
#define LOAD_FONT6 // Load Font6
#define LOAD_FONT7 // Load Font7
#define LOAD_FONT8 // Load Font8
#define LOAD_GFXFF // Load GFX font
#define SMOOTH_FONT // Enable smooth fonts
5๏ธโฃ Upload the Firmware
bash
# Step-by-step upload process:
Open the firmware:
File โ Open
Navigate to firmware/N3XUS_V7.1.ino
Click Open
Select the board:
Tools โ Board โ ESP32 Dev Module
Configure board settings:
Tools โ CPU Frequency: 240MHz
Tools โ Flash Size: 4MB
Tools โ Partition Scheme: Default
Tools โ Upload Speed: 115200
Select the port:
Tools โ Port โ Select your COM port
Windows: COM3, COM4, etc.
Mac: /dev/cu.usbserial-*
Linux: /dev/ttyUSB0, /dev/ttyACM0
Upload:
Click the Upload button (โ)
Wait for compilation and upload
Look for "Done uploading" message
Troubleshooting Upload Issues:
Issue Solution
"Failed to connect" Hold BOOT button, press EN, release BOOT, try again
"Timed out" Reduce Upload Speed to 115200
"Port not found" Install USB drivers (CP2102 or CH340)
"Compilation error" Verify all libraries are installed
6๏ธโฃ Connect to the Device
bash
# After successful upload:
WiFi Connection:
Open WiFi settings on your device
Find network: N3XUS
Enter password: 12345678
Wait for connection
Web Panel Access:
Open web browser
Navigate to: http://192.168.4.1
The N3XUS web panel should appear
Serial Monitor:
Tools โ Serial Monitor
Baud rate: 115200
View system logs and debug messages
๐ ๏ธ Troubleshooting Guide
Common Issues and Solutions
Issue Solution
TFT white screen 1. Check User_Setup.h โ Enable ST7789_DRIVER
2. Verify CS (GPIO 2), DC (GPIO 16), RST (GPIO 5)
3. Check 3.3V power supply
4. BLK pin must be connected to 3.3V
NRF not found 1. Add 10ยตF capacitor between VCC and GND
2. Verify CE/CSN pins
3. Check 3.3V power with multimeter
4. Ensure PA+LNA version is used
CC1101 fails 1. Check CS pin (GPIO 16)
2. Install ELECHOUSE_CC1101 library
3. Verify SPI connections
4. Check GDO0 pin connection
SD Card not reading 1. Format SD Card as FAT32
2. Maximum 32GB capacity
3. Check CS pin (GPIO 14)
4. Try a different SD card
Web panel not loading 1. Connect to N3XUS WiFi
2. Open http://192.168.4.1
3. Disable firewall temporarily
4. Check WiFi connection
Upload fails 1. Remove all wires from ESP32
2. Hold BOOT โ Press EN โ Release BOOT
3. Select correct COM port
4. Try different USB cable
Constant reboots 1. Use 5V 2A power supply
2. Add 1000ยตF capacitor
3. Check power connections
4. Check for short circuits
Buttons not working 1. Use INPUT_PULLUP in code
2. Verify GPIO connections to GND
3. Check debounce delay
4. Test with multimeter
OLED not working 1. Check I2C address (0x3C or 0x3D)
2. Verify SDA/SCL pins
3. Check 3.3V power
4. Try different OLED library
WiFi not connecting 1. Verify AP_SSID and AP_PASS
2. Check ESP32 WiFi antenna
3. Reset device
4. Check for interference
Advanced Troubleshooting
Checking Power Supply:
bash
# Using multimeter:
# 1. Measure voltage between VCC and GND: should be 3.3V
# 2. Measure current draw: should be < 500mA idle
# 3. Check for voltage drops during operation
Checking SPI Communication:
bash
# In Serial Monitor:
# Look for:
# - "NRF1 OK" messages
# - "CC1101 OK" messages
# - SPI initialization success messages
# - Any error messages
Testing Individual Components:
cpp
// Test NRF24 only
#include
RF24 radio(25, 26);
void setup() {
Serial.begin(115200);
if(radio.begin()) Serial.println("NRF OK");
}
// Test TFT only
#include
TFT_eSPI tft;
void setup() {
tft.init();
tft.fillScreen(TFT_RED);
}
// Test CC1101 only
#include
void setup() {
Serial.begin(115200);
ELECHOUSE_cc1101.Init();
Serial.println("CC1101 OK");
}
๐ Documentation Structure
text
N3XUS/
โโโ README.md โ You are here!
โโโ LICENSE โ MIT License
โโโ .gitignore โ Git ignore rules
โโโ firmware/
โ โโโ N3XUS_V7.1.ino โ Main firmware
โ โโโ libraries/ โ Required libraries
โโโ hardware/
โ โโโ schematic.png โ Circuit schematic
โ โโโ pinout.png โ ESP32 pinout
โ โโโ wiring_diagram.png โ Breadboard diagram
โโโ docs/
โ โโโ setup_guide.md โ Detailed setup instructions
โ โโโ commands.md โ Command reference
โ โโโ troubleshooting.md โ Troubleshooting guide
โโโ assets/
โ โโโ images/ โ Project images
โ โโโ videos/ โ Demo videos
โโโ web/
โโโ panel.html โ Web panel HTML
๐ง Advanced Configuration
Customizing WiFi Settings
cpp
// In firmware/N3XUS_V7.1.ino
// Find these lines at the top of the file:
const char* AP_SSID = "N3XUS"; // Change network name (max 32 chars)
const char* AP_PASS = "12345678"; // Change password (min 8 chars)
Adjusting NRF24 Power Levels
cpp
// In initNRF() function
// Change the third parameter:
// Power Level Options:
// RF24_PA_MIN - ~-18dBm (lowest power)
// RF24_PA_LOW - ~-12dBm (low power)
// RF24_PA_HIGH - ~-6dBm (medium power)
// RF24_PA_MAX - ~0dBm (maximum power)
radio.setPALevel(RF24_PA_LOW); // For battery saving
radio.setPALevel(RF24_PA_HIGH); // Balanced mode
radio.setPALevel(RF24_PA_MAX); // Maximum range
Changing CC1101 Frequency
cpp
// In executeMode() function
// Use setMHZ() function:
ELECHOUSE_cc1101.setMHZ(433.92); // 433 MHz band
ELECHOUSE_cc1101.setMHZ(868.0); // 868 MHz band
ELECHOUSE_cc1101.setMHZ(915.0); // 915 MHz band
ELECHOUSE_cc1101.setMHZ(434.0); // Alternative 434 MHz
Modifying Button Functions
cpp
// In loop() function
// Change the button actions:
if(readButton(SW1)) {
// SW1 action - currently page change
currentPage = (PageState)((currentPage + 1) % 4);
updatePage();
}
if(readButton(SW2)) {
// SW2 action - currently execute mode
if(systemActive && currentState == STATE_IDLE) {
executeMode(currentMode);
}
}
if(readButton(SW3)) {
// SW3 action - currently change mode
changeMode(1);
updatePage();
}
Adding Custom Modes
cpp
// 1. Add to OperationMode enum:
enum OperationMode {
MODE_OMNISCIENT,
// ... existing modes ...
MODE_CUSTOM, // โ Add new mode
MODE_OMEGA
};
// 2. Add name to modeNames array:
const char* modeNames[] = {
"Omniscient",
// ... existing names ...
"Custom Mode", // โ Add new name
"Omega"
};
// 3. Add to executeMode() function:
case MODE_CUSTOM:
// Your custom code here
showResult("โจ Custom Mode", "Custom operation executed", TFT_CYAN);
break;
๐ค Contributing
We welcome contributions! Here's how:
Fork the Repository
Navigate to github.com/here-is-leo/N3XUS
Click "Fork" button (top right)
Choose your account
Wait for fork to complete
Create a Feature Branch
bash
# Clone your fork
git clone https://github.com/your-username/N3XUS.git
cd N3XUS
# Create feature branch
git checkout -b feature/amazing-feature
Make Your Changes
bash
# Make your changes to the code
# Add new files if needed
# Update documentation
# Test thoroughly
Commit and Push
bash
# Stage changes
git add .
# Commit with clear message
git commit -m 'Add amazing feature'
# Push to your fork
git push origin feature/amazing-feature
Open a Pull Request
Go to your fork on GitHub
Click "Pull Request" button
Select branch: feature/amazing-feature
Fill in the PR template
Submit the pull request
Contribution Guidelines
Guideline Description
Code Style Follow existing code formatting
Comments Add comments for complex logic
Testing Test your changes thoroughly
Documentation Update docs as needed
Commit Messages Use clear, descriptive messages
Single Purpose Each PR should address one issue
๐ License
This project is licensed under the MIT License โ see the LICENSE file for details.
text
MIT License
Copyright (c) 2026 Ilya Farahani (Leo)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
License Summary
Permission Commercial Use Modification Distribution Private Use
โ
Yes โ
Yes โ
Yes โ
Yes โ
Yes
Conditions:
Include original copyright notice
Include license text in distribution
No warranty or liability
๐ฌ Contact & Support
Developer Information
Field Details
Name Ilya Farahani (Leo)
Title Senior Backend Developer & Security Researcher
Location Tehran, Iran
Experience 4-5 years production systems
Specialization Python, C#, Security, APIs
Contact Channels
Channel Link
GitHub github.com/here-is-leo
Blog here-is-leo-blog.ilyafarahanii.workers.dev
Email ilyafarahanii@gmail.com
Telegram @here_is_leo
LinkedIn linkedin.com/in/ilya-farahani
Support Options
Option Description
โญ Star the repository Show appreciation on GitHub
๐ต Buy me a coffee coffeebede.com/leo
๐ Report issues Submit bug reports on GitHub
๐ Contribute docs Help improve documentation
๐ง Submit PRs Contribute code improvements
๐ Acknowledgments
Open Source Libraries
Library Author Purpose
TFT_eSPI Bodmer TFT display driver
RF24 TMRh20 NRF24 communication
ELECHOUSE_CC1101 ELECHOUSE CC1101 communication
ArduinoJson bblanchon JSON parsing
Inspiration & References
Resource Description
ESP32 Community Hardware and software support
RF Security Research Academic and practical papers
Open Source Security Tools Community projects and tools
Cybersecurity Education Learning platforms and courses
Special Thanks
All contributors and testers
Security researchers pushing ethical boundaries
Open-source community for accessible knowledge
ESP32 development team
RF24 and CC1101 library maintainers
๐ Project Status
Metric Status
Version v7.1
Release Date August 2026
Stability Stable
Documentation Complete
Test Coverage Extensive
Community Growing
๐ Roadmap
Upcoming Features
Feature Status Expected
BLE Attack Mode ๐ก In Development Q3 2026
Mobile App Control ๐ต Planned Q4 2026
GPS Integration ๐ต Planned Q1 2027
AI-based Detection ๐ต Planned Q2 2027
Automated Reporting ๐ก In Development Q3 2026
Long-term Vision
โก Full SDR integration
โก Cloud-based analysis
โก Multi-device coordination
โก Advanced AI features
โก Commercial hardware version
โญ If you find this project useful, please consider giving it a star!
Report Bug ยท Request Feature ยท Read Docs
Made with โค๏ธ by Leo
"Security is not a product, but a process." โ Bruce Schneier
```"## Installation"
"## Project Status: Active Development"