⚡ N3XUS

💬 "Security is not a product, but a process."

— Bruce Schneier

🚨 IMPORTANT LEGAL NOTICE

Caution

╔══════════════════════════════════════════════════════════════════╗ ║ 🚫 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. ║ ╚══════════════════════════════════════════════════════════════════╝

📡 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 & signal analysis}	⚔️ Attack Simulation _{Deauth, packet injection, jamming}	🎭 Deception Techniques _{Rogue AP, MAC spoofing, manipulation}
🛡️ Network Security Testing _{WPA/WPA2 handshake & PMKID capture}	📊 Real-time Visualization _{TFT display with live statistics}	🌐 Remote Control _{Web dashboard 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	✅ Yes	✅ Limited	✅ Yes	❌ No
📡 3x NRF24 Modules	✅ Simultaneous	❌ No	❌ No	❌ No
🌐 Web Panel	✅ Built-in	❌ No	❌ No	❌ No
🖥️ TFT Display	✅ 1.69" Color	❌ No	❌ No	❌ No
💾 SD Logging	✅ Included	✅ Included	❌ No	❌ No
🎮 12 Modes	✅ Comprehensive	✅ Limited	❌ No	❌ No
🔓 Open Source	✅ MIT	❌ Closed	⚠️ Partial	✅ GNU
🎓 Educational Value	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐

🚀 Quick Start

# 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 (click to expand)

Component	Qty	Specifications	Price (USD)	Price (IRR)
ESP32 Dev Board	1	38-pin, WROOM-32, 4MB Flash	$8–12	150,000–300,000
NRF24+PA+LNA	3	2.4GHz, external antenna	$10–15 ea	250,000–400,000
CC1101 Transceiver	1	Sub-1GHz, with antenna	$8–12	200,000–350,000
TFT Display 1.69"	1	ST7789, 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	$5–10	100,000–200,000
AMS1117 3.3V	1	With heatsink	$2–3	50,000–80,000
Capacitors	×	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	M-M, M-F	$5–10	100,000–200,000
5V 2A Power Supply	1	USB charger / power bank	$10–15	250,000–400,000

🧩 Optional Components (click to expand)

Component	Description	Price
18650 Li-ion Battery	Portable operation	$5–10
TP4056 Charger Module	Battery charging	$2–3
Boost Converter	3.7V → 5V step-up	$2–4
Enclosure/Case	3D printed / project box	$10–20
External Antennas	Improved range	$5–15 ea

💵 Total Estimated Cost: $80–120 (1,500,000 – 2,500,000 IRR)

🔌 Pinout Diagram

📐 ESP32 30-Pin Pinout (click to expand)

┌─────────────────────────────────────────────────────────────────────┐
│                     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 (click to expand)

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)	Undetectable reconnaissance
3	Spectrum Analyzer	📊	Real-time signal strength visualization	RF environment analysis
4	Device Finder	🎯	Targeted 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 specific channel	Precision strikes
7	Blackout	🌑	Full frequency jamming	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 & MITM
10	Chameleon	🦎	MAC address spoofing	Hide identity
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 (click to expand)

┌─────────────────────────────────────────────────────────────────┐
│  ⚡ 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                             │
└─────────────────────────────────────────────────────────────────┘

Feature	Description
📊 Real-time status monitoring	Live system state (ONLINE/OFFLINE)
🎮 Mode selection & execution	Choose from 12 modes with one click
📈 Live packet statistics	Track packets sent/received in real-time
🌐 Network discovery results	View detected networks & signal strength
⚡ Command execution interface	Run scans, attacks, operations
📱 Mobile-responsive design	Works on phones, tablets, desktops
🔄 Auto-refresh every 2s	Always up-to-date info
🌙 Dark theme	Eye-friendly for extended use

📖 Step-by-Step Setup Guide

1️⃣ Install Arduino IDE

# Windows / Mac / Linux
# Download from: https://www.arduino.cc/en/software
# Install version 1.8.19 or newer

Windows:

Download the Windows installer (.exe)
Run the installer
Follow the wizard, accept the license
Choose install directory
Select "Install USB drivers"
Complete installation

macOS:

Download the Mac version (.dmg)
Open the .dmg file
Drag Arduino.app to Applications
Open Arduino from Applications

Linux:

# Ubuntu/Debian
sudo apt update
sudo apt install arduino

# Or download the Linux AppImage
chmod +x arduino-*.AppImage
./arduino-*.AppImage

2️⃣ Add ESP32 Board Support

# 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"

3️⃣ Install Required 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`	SD card interface
SPI	Built-in	`SPI`	SPI communication
WiFi	Built-in	`WiFi`	WiFi connectivity
WebServer	Built-in	`WebServer`	Web server

4️⃣ Configure TFT_eSPI Library

Navigate to libraries/TFT_eSPI/User_Setup.h and configure:

// ==========================================
// DISPLAY DRIVER
// ==========================================
#define ST7789_DRIVER           // Enable ST7789 driver

// ==========================================
// DISPLAY RESOLUTION
// ==========================================
#define TFT_WIDTH  240
#define TFT_HEIGHT 280

// ==========================================
// PIN CONFIGURATION
// ==========================================
#define TFT_CS   2
#define TFT_DC   16
#define TFT_RST  5
#define TFT_SCLK 18
#define TFT_MOSI 23
#define TFT_MISO 19

// ==========================================
// BACKLIGHT
// ==========================================
#define TFT_BACKLIGHT_ON HIGH

// ==========================================
// FONTS
// ==========================================
#define LOAD_GLCD
#define LOAD_FONT2
#define LOAD_FONT4
#define LOAD_FONT6
#define LOAD_FONT7
#define LOAD_FONT8
#define LOAD_GFXFF
#define SMOOTH_FONT

5️⃣ Upload the Firmware

# Open firmware
File ← Open ← firmware/N3XUS_V7.1.ino

# Select the board
Tools ← Board ← ESP32 Dev Module

# Configure 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, ...
# Mac:     /dev/cu.usbserial-*
# Linux:   /dev/ttyUSB0, /dev/ttyACM0

# Upload
Click the Upload button (→)
Wait for "Done uploading" message

Troubleshooting Upload Issues:

Issue	Solution
"Failed to connect"	Hold BOOT, press EN, release BOOT, retry
"Timed out"	Reduce Upload Speed to 115200
"Port not found"	Install USB drivers (CP2102 / CH340)
"Compilation error"	Verify all libraries are installed

6️⃣ Connect to the Device

# 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

# 📟 Serial Monitor
Tools ← Serial Monitor
Baud rate: 115200
View system logs and debug messages

🛠️ Troubleshooting Guide

🔧 Common Issues & Solutions (click to expand)

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 supply 4. BLK pin → 3.3V
📡 NRF not found	1. Add 10µF capacitor VCC↔GND 2. Verify CE/CSN pins 3. Check 3.3V with multimeter 4. Ensure PA+LNA version
📻 CC1101 fails	1. Check CS pin (GPIO 16) 2. Install `ELECHOUSE_CC1101` library 3. Verify SPI connections 4. Check GDO0 pin
💾 SD not reading	1. Format as FAT32 2. Max 32GB 3. Check CS (GPIO 14) 4. Try another card
🌐 Web panel not loading	1. Connect to N3XUS WiFi 2. Open http://192.168.4.1 3. Disable firewall temporarily
⬆️ Upload fails	1. Remove all wires from ESP32 2. BOOT → EN → release BOOT 3. Select correct COM port 4. Try different USB cable
🔄 Constant reboots	1. Use 5V 2A supply 2. Add 1000µF capacitor 3. Check power connections 4. Check for shorts
🔘 Buttons not working	1. Use `INPUT_PULLUP` 2. Verify GPIO → GND 3. Check debounce delay
📟 OLED not working	1. Check I2C address (0x3C / 0x3D) 2. Verify SDA/SCL pins 3. Check 3.3V
📶 WiFi not connecting	1. Verify `AP_SSID` / `AP_PASS` 2. Check ESP32 antenna 3. Reset device 4. Check interference

🧪 Testing Individual Components

// Test NRF24 only
#include <RF24.h>
RF24 radio(25, 26);
void setup() {
  Serial.begin(115200);
  if(radio.begin()) Serial.println("NRF OK");
}

// Test TFT only
#include <TFT_eSPI.h>
TFT_eSPI tft;
void setup() {
  tft.init();
  tft.fillScreen(TFT_RED);
}

// Test CC1101 only
#include <ELECHOUSE_CC1101.h>
void setup() {
  Serial.begin(115200);
  ELECHOUSE_cc1101.Init();
  Serial.println("CC1101 OK");
}

📚 Documentation Structure

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
│   ├── commands.md           ← Command reference
│   └── troubleshooting.md    ← Troubleshooting
├── assets/
│   ├── images/               ← Project images
│   └── videos/               ← Demo videos
└── web/
    └── panel.html            ← Web panel HTML

🔧 Advanced Configuration

📶 Customizing WiFi Settings

// In firmware/N3XUS_V7.1.ino
const char* AP_SSID = "N3XUS";        // Network name (max 32 chars)
const char* AP_PASS = "12345678";     // Password (min 8 chars)

📡 Adjusting NRF24 Power Levels

// Power Level Options:
// RF24_PA_MIN   - ~-18dBm (lowest)
// RF24_PA_LOW   - ~-12dBm (low)
// RF24_PA_HIGH  - ~-6dBm  (medium)
// RF24_PA_MAX   - ~0dBm   (maximum)

radio.setPALevel(RF24_PA_LOW);    // Battery saving
radio.setPALevel(RF24_PA_HIGH);   // Balanced
radio.setPALevel(RF24_PA_MAX);    // Max range

📻 Changing CC1101 Frequency

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

if(readButton(SW1)) {
  currentPage = (PageState)((currentPage + 1) % 4);
  updatePage();
}

if(readButton(SW2)) {
  if(systemActive && currentState == STATE_IDLE) {
    executeMode(currentMode);
  }
}

if(readButton(SW3)) {
  changeMode(1);
  updatePage();
}

➕ Adding Custom Modes

// 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:
  showResult("✨ Custom Mode", "Custom operation executed", TFT_CYAN);
  break;

🤝 Contributing

1️⃣
Fork

2️⃣
Branch

3️⃣
Change

4️⃣
Commit

5️⃣
Push

6️⃣
PR

# 1. Fork the repository
# Go to github.com/here-is-leo/N3XUS → Click "Fork"

# 2. Clone your fork
git clone https://github.com/your-username/N3XUS.git
cd N3XUS

# 3. Create a feature branch
git checkout -b feature/amazing-feature

# 4. Make your changes
# ... edit files ...

# 5. Stage and commit
git add .
git commit -m 'Add amazing feature'

# 6. Push to your fork
git push origin feature/amazing-feature

# 7. Open a Pull Request on GitHub

Guideline	Description
🎨 Code Style	Follow existing formatting
💬 Comments	Add comments for complex logic
🧪 Testing	Test thoroughly
📖 Documentation	Update docs as needed
✍️ Commit Messages	Clear, descriptive messages
🎯 Single Purpose	Each PR addresses one issue

📜 License

MIT License — see the LICENSE file for details.

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.

Permission	Commercial	Modification	Distribution	Private Use
✅ Yes	✅ Yes	✅ Yes	✅ Yes	✅ Yes

Conditions: Include original copyright notice · Include license text · No warranty or liability

📬 Contact & Support

👤 Developer

Ilya Farahani (Leo) Senior Backend Developer & Security Researcher

📍 Tehran, Iran 💼 4–5 years production systems 🔧 Python · C# · Security · APIs

📞 Channels

Channel	Link
🐙 GitHub	here-is-leo
✍️ Blog	here-is-leo-blog
📧 Email	ilyafarahanii@gmail.com
💬 Telegram	@here_is_leo
💼 LinkedIn	ilya-farahani

💖 Support Options

Option	Description
⭐	Star the repository
🍵	Buy me a coffee
🐛	Report issues on GitHub
📖	Contribute to docs
🔧	Submit PRs

🙏 Acknowledgments

Library	Author	Purpose
TFT_eSPI	Bodmer	TFT display driver
RF24	TMRh20	NRF24 communication
ELECHOUSE_CC1101	ELECHOUSE	CC1101 communication
ArduinoJson	bblanchon	JSON parsing

Special thanks to:

🌍 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: Active Development

Metric	Status
Version	`v7.1`
Release Date	August 2026
Stability	🟢 Stable
Documentation	🟢 Complete
Test Coverage	🟢 Extensive
Community	🟡 Growing

🚀 Roadmap

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!

Made with ❤️ by Leo

"Security is not a product, but a process." — Bruce Schneier

⚡ N3XUS

💬 «امنیت یک محصول نیست، بلکه یک فرآیند است.»

— بروس اشنایر

🚨 اطلاعیه قانونی مهم

[!CAUTION] ╔══════════════════════════════════════════════════════════════════╗ ║ 🚫 این ابزار صرفاً برای اهداف آموزشی و تحقیقاتی 🚫 ║ ║ ارائه شده است. نویسنده هیچ‌گونه استفاده غیرقانونی از ║ ║ این فناوری را تأیید یا پشتیبانی نمی‌کند. استفاده از این ║ ║ ابزار علیه شبکه‌ها یا دستگاه‌ها بدون اجازه صریح ║ ║ غیرقانونی است و ممکن است منجر به مجازات‌های شدید تحت ║ ║ قوانین محلی و بین‌المللی شود. با استفاده از این ابزار، شما ║ ║ موافقت می‌کنید که مسئولیت کامل اعمال خود را بپذیرید. ║ ╚══════════════════════════════════════════════════════════════════╝

📡 N3XUS چیست؟

N3XUS یک جعبه‌ابزار جنگ الکترونیک (EW) قابل حمل و پیشرفته است که بر پایه میکروکنترلر قدرتمند ESP32 ساخته شده است. این پروژه سه ماژول NRF24L01+ PA+LNA را برای عملیات 2.4GHz و یک فرستنده-گیرنده CC1101 را برای باندهای فرکانسی زیر 1GHz ادغام می‌کند و پلتفرمی جامع برای موارد زیر فراهم می‌آورد:

🔍 شناسایی RF _{اسکن کامل طیف و تحلیل سیگنال}	⚔️ شبیه‌سازی حمله _{Deauth، تزریق بسته، اختلال}	🎭 تکنیک‌های فریب _{AP جعلی، جعل MAC، دستکاری}
🛡️ تست امنیت شبکه _{ضبط دست‌دادن WPA/WPA2 و PMKID}	📊 نمایش بلادرنگ _{نمایشگر TFT با آمار زنده}	🌐 کنترل از راه دور _{داشبورد وب از طریق WiFi}

🎯 چرا N3XUS؟

ویژگی	⚡ N3XUS	🐬 Flipper Zero	📻 HackRF	📡 RTL-SDR
💰 هزینه	~$50	~$200	~$400	~$30
📶 باندهای فرکانسی	2.4GHz + زیر ۱GHz	زیر ۱GHz + RFID	۱MHz–۶GHz	۲۴MHz–۱.۷GHz
📤 قابلیت ارسال	✅ بله	✅ محدود	✅ بله	❌ خیر
📡 ۳x ماژول NRF24	✅ همزمان	❌ خیر	❌ خیر	❌ خیر
🌐 پنل وب	✅ داخلی	❌ خیر	❌ خیر	❌ خیر
🖥️ نمایشگر TFT	✅ رنگی ۱.۶۹ اینچ	❌ خیر	❌ خیر	❌ خیر
💾 لاگ روی SD	✅ دارد	✅ دارد	❌ خیر	❌ خیر
🎮 ۱۲ حالت	✅ جامع	✅ محدود	❌ خیر	❌ خیر
🔓 متن‌باز	✅ MIT	❌ بسته	⚠️ جزئی	✅ GNU
🎓 ارزش آموزشی	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐

🚀 شروع سریع

# ۱️⃣ مخزن را کلون کنید
git clone https://github.com/here-is-leo/N3XUS.git

# ۲️⃣ وارد پوشه پروژه شوید
cd N3XUS

# ۳️⃣ فریمور را در Arduino IDE باز کنید
#    File → Open → firmware/N3XUS_V7.1.ino

# ۴️⃣ کتابخانه‌های موردنیاز را نصب کنید (به پایین مراجعه کنید)

# ۵️⃣ روی ESP32 آپلود کنید
#    Tools → Board → ESP32 Dev Module
#    Tools → Port → پورت COM خود را انتخاب کنید
#    دکمه Upload ⬆️ را بزنید

# ۶️⃣ به دستگاه متصل شوید
#    📶 WiFi:        N3XUS
#    🔑 رمز عبور:    12345678
#    🌐 پنل وب:      http://192.168.4.1

📦 سخت‌افزار موردنیاز

🔧 قطعات ضروری (برای گسترش کلیک کنید)

قطعه	تعداد	مشخصات	قیمت (دلار)	قیمت (تومان)
برد ESP32	۱	۳۸ پین، WROOM-32، ۴MB فلش	$۸–۱۲	۱۵۰,۰۰۰–۳۰۰,۰۰۰
NRF24+PA+LNA	۳	2.4GHz، با آنتن خارجی	هر کدام $۱۰–۱۵	۲۵۰,۰۰۰–۴۰۰,۰۰۰
CC1101	۱	زیر ۱GHz، با آنتن	$۸–۱۲	۲۰۰,۰۰۰–۳۵۰,۰۰۰
نمایشگر TFT 1.69"	۱	ST7789، 240x280	$۱۲–۱۸	۳۰۰,۰۰۰–۵۰۰,۰۰۰
OLED 0.96"	۱	I2C، SSD1306 (اختیاری)	$۳–۵	۸۰,۰۰۰–۱۵۰,۰۰۰
خواننده SD	۱	رابط SPI	$۲–۴	۵۰,۰۰۰–۱۰۰,۰۰۰
کارت Micro SD	۱	۴–۳۲GB، FAT32	$۵–۱۰	۱۰۰,۰۰۰–۲۰۰,۰۰۰
AMS1117 3.3V	۱	با هیت‌سینک	$۲–۳	۵۰,۰۰۰–۸۰,۰۰۰
خازن‌ها	چند	۱۰µF، ۱۰۰µF، ۲۲µF	$۲–۵	۵۰,۰۰۰–۱۰۰,۰۰۰
LED (۵ رنگ)	۵	با مقاومت ۲۲۰Ω	$۳–۵	۸۰,۰۰۰–۱۵۰,۰۰۰
دکمه‌های فشاری	۳	سوئیچ لمسی	$۲–۳	۵۰,۰۰۰–۸۰,۰۰۰
بردبورد	۲+	بزرگ + کوچک	$۱۰–۱۵	۲۵۰,۰۰۰–۴۰۰,۰۰۰
سیم جامپر	ست	نر-نر، نر-ماده	$۵–۱۰	۱۰۰,۰۰۰–۲۰۰,۰۰۰
منبع تغذیه 5V 2A	۱	شارژر USB / پاوربانک	$۱۰–۱۵	۲۵۰,۰۰۰–۴۰۰,۰۰۰

🧩 قطعات اختیاری (برای گسترش کلیک کنید)

قطعه	توضیحات	قیمت
باتری 18650	برای کار قابل حمل	$۵–۱۰
ماژول شارژ TP4056	شارژ باتری	$۲–۳
مبدل Boost	۳.۷V به ۵V	$۲–۴
قاب/جعبه	چاپ سه‌بعدی / جعبه پروژه	$۱۰–۲۰
آنتن‌های خارجی	افزایش برد	هر کدام $۵–۱۵

💵 هزینه تقریبی کل: $۸۰–۱۲۰ (۱,۵۰۰,۰۰۰ – ۲,۵۰۰,۰۰۰ تومان)

🎮 ۱۲ حالت عملیاتی

📡 شناسایی — اسکن و کشف

#	حالت	آیکون	توضیحات	کاربرد
۱	Omniscient	📡	اسکن کامل ۱۲۵ کانال (2.4GHz + زیر ۱GHz)	کشف همه دستگاه‌های در محدوده
۲	Shadow	👤	اسکن مخفیانه (فقط دریافت)	شناسایی غیرقابل‌ردیابی
۳	Spectrum Analyzer	📊	نمایش بلادرنگ قدرت سیگنال	تحلیل محیط RF
۴	Device Finder	🎯	کشف هدفمند (دوربین‌ها، پهپادها)	مکانیابی دستگاه خاص

⚔️ حمله — عملیات تهاجمی

#	حالت	آیکون	توضیحات	کاربرد
۵	Annihilator	💥	حمله چندکاناله به همه شبکه‌ها	اخلال گسترده
۶	Sniper	🎯	حمله هدفمند به یک کانال خاص	ضربات دقیق
۷	Blackout	🌑	اختلال کامل فرکانسی	خاموشی کامل سیگنال
۸	Zombie	🧟	تزریق بسته به شبکه‌های هدف	سردرگم کردن سیستم‌های امنیتی

🎭 فریب — مهندسی اجتماعی

#	حالت	آیکون	توضیحات	کاربرد
۹	Mirage	🎭	ساخت AP جعلی	فیشینگ و MITM
۱۰	Chameleon	🦎	جعل آدرس MAC	مخفی کردن هویت
۱۱	Puppet	🎪	کنترل دستگاه‌های IoT	دستکاری دستگاه‌های هوشمند

🔄 ترکیبی — عملیات ترکیبی

#	حالت	آیکون	توضیحات	کاربرد
۱۲	Omega	🌀	حالت ترکیبی (اسکن+حمله+تزریق)	عملیات پیشرفته

🖥️ امکانات پنل وب

ویژگی	توضیحات
📊 نظارت بلادرنگ	وضعیت زنده سیستم (ONLINE/OFFLINE)
🎮 انتخاب و اجرای حالت	انتخاب از بین ۱۲ حالت با یک کلیک
📈 آمار زنده بسته‌ها	ردیابی بسته‌های ارسالی/دریافتی در زمان واقعی
🌐 نتایج کشف شبکه	مشاهده شبکه‌های شناسایی‌شده و قدرت سیگنال
⚡ رابط اجرای دستور	اجرای اسکن، حمله، عملیات
📱 طراحی واکنش‌گرا	کار روی موبایل، تبلت، دسکتاپ
🔄 به‌روزرسانی هر ۲ ثانیه	اطلاعات همیشه به‌روز
🌙 تم تیره	طراحی مناسب چشم برای استفاده طولانی

🛠️ راهنمای عیب‌یابی

🔧 مشکلات رایج و راه‌حل‌ها (برای گسترش کلیک کنید)

مشکل	راه‌حل
🖥️ صفحه سفید TFT	۱. `User_Setup.h` → فعال‌سازی `ST7789_DRIVER` ۲. بررسی CS (GPIO 2)، DC (GPIO 16)، RST (GPIO 5) ۳. بررسی تغذیه ۳.۳V ۴. پین BLK → ۳.۳V
📡 NRF پیدا نمی‌شود	۱. افزودن خازن ۱۰µF بین VCC و GND ۲. بررسی پین‌های CE/CSN ۳. بررسی ۳.۳V با مولتی‌متر ۴. اطمینان از نسخه PA+LNA
📻 CC1101 کار نمی‌کند	۱. بررسی پین CS (GPIO 16) ۲. نصب کتابخانه `ELECHOUSE_CC1101` ۳. بررسی اتصالات SPI ۴. بررسی پین GDO0
💾 SD خوانده نمی‌شود	۱. فرمت FAT32 ۲. حداکثر ۳۲GB ۳. بررسی CS (GPIO 14) ۴. تست کارت دیگر
🌐 پنل وب باز نمی‌شود	۱. اتصال به WiFi N3XUS ۲. باز کردن http://192.168.4.1 ۳. غیرفعال کردن موقت فایروال
⬆️ آپلود شکست می‌خورد	۱. حذف همه سیم‌ها از ESP32 ۲. BOOT → EN → رها کردن BOOT ۳. انتخاب پورت COM صحیح ۴. تست کابل USB دیگر
🔄 ریبوت مداوم	۱. استفاده از منبع ۵V 2A ۲. افزودن خازن ۱۰۰۰µF ۳. بررسی اتصالات برق ۴. بررسی اتصال کوتاه
🔘 دکمه‌ها کار نمی‌کنند	۱. استفاده از `INPUT_PULLUP` ۲. بررسی اتصال GPIO به GND ۳. بررسی تأخیر debounce
📟 OLED کار نمی‌کند	۱. بررسی آدرس I2C (0x3C / 0x3D) ۲. بررسی پین‌های SDA/SCL ۳. بررسی ۳.۳V
📶 WiFi وصل نمی‌شود	۱. بررسی `AP_SSID` / `AP_PASS` ۲. بررسی آنتن ESP32 ۳. ریست دستگاه ۴. بررسی تداخل

🤝 مشارکت

۱️⃣
Fork

۲️⃣
Branch

۳️⃣
تغییر

۴️⃣
Commit

۵️⃣
Push

۶️⃣
PR

# ۱. مخزن را فورک کنید
# به github.com/here-is-leo/N3XUS بروید → روی "Fork" کلیک کنید

# ۲. فورک خود را کلون کنید
git clone https://github.com/your-username/N3XUS.git
cd N3XUS

# ۳. یک شاخه ویژگی بسازید
git checkout -b feature/amazing-feature

# ۴. تغییرات خود را اعمال کنید

# ۵. Stage و Commit کنید
git add .
git commit -m 'Add amazing feature'

# ۶. به فورک خود Push کنید
git push origin feature/amazing-feature

# ۷. یک Pull Request در GitHub باز کنید

دستورالعمل	توضیحات
🎨 سبک کد	از قالب‌بندی موجود پیروی کنید
💬 کامنت‌ها	برای منطق پیچیده کامنت اضافه کنید
🧪 تست	به‌طور کامل تست کنید
📖 مستندات	در صورت نیاز مستندات را به‌روز کنید
✍️ پیام‌های Commit	واضح و توصیفی باشند
🎯 هدف واحد	هر PR یک مسئله را حل کند

📜 مجوز

مجوز MIT — برای جزئیات به فایل LICENSE مراجعه کنید.

اجازه	تجاری	تغییر	توزیع	استفاده خصوصی
✅ بله	✅ بله	✅ بله	✅ بله	✅ بله

شرایط: درج اطلاعیه کپی‌رایت اصلی · درج متن مجوز · بدون گارانتی یا مسئولیت

📬 تماس و پشتیبانی

👤 توسعه‌دهنده

ایلیا فراهانی (Leo) توسعه‌دهنده ارشد بک‌اند و محقق امنیت

📍 تهران، ایران 💼 ۴–۵ سال سیستم‌های عملیاتی 🔧 Python · C# · امنیت · APIها

📞 کانال‌های ارتباطی

کانال	لینک
🐙 GitHub	here-is-leo
✍️ Blog	here-is-leo.ir
💬 تلگرام	@here_is_leo
💼 لینکدین	ilya-farahani

💖 گزینه‌های پشتیبانی

گزینه	توضیحات
⭐	ستاره دادن به مخزن
🍵	خرید یک قهوه برای من
🐛	گزارش مشکلات در GitHub
📖	کمک به بهبود مستندات
🔧	ارسال PR

🙏 تشکر و قدردانی

کتابخانه	نویسنده	هدف
TFT_eSPI	Bodmer	درایور نمایشگر TFT
RF24	TMRh20	ارتباط NRF24
ELECHOUSE_CC1101	ELECHOUSE	ارتباط CC1101
ArduinoJson	bblanchon	تجزیه JSON

تشکر ویژه از:

🌍 همه مشارکت‌کنندگان و تست‌کنندگان
🔬 محققان امنیتی که مرزهای اخلاقی را پیش می‌برند
📖 جامعه متن‌باز برای دانش در دسترس
⚡ تیم توسعه ESP32
📡 نگهدارندگان کتابخانه‌های RF24 و CC1101

📈 وضعیت پروژه: توسعه فعال

معیار	وضعیت
نسخه	`v7.1`
تاریخ انتشار	مرداد ۱۴۰۵
پایداری	🟢 پایدار
مستندات	🟢 کامل
پوشش تست	🟢 گسترده
جامعه	🟡 در حال رشد

🚀 نقشه راه

ویژگی	وضعیت	زمان تخمینی
حالت حمله BLE	🟡 در حال توسعه	Q3 2026
کنترل اپلیکیشن موبایل	🔵 برنامه‌ریزی‌شده	Q4 2026
ادغام GPS	🔵 برنامه‌ریزی‌شده	Q1 2027
تشخیص مبتنی بر AI	🔵 برنامه‌ریزی‌شده	Q2 2027
گزارش‌گیری خودکار	🟡 در حال توسعه	Q3 2026

چشم‌انداز بلندمدت:

☐ ادغام کامل SDR
☐ تحلیل مبتنی بر ابر
☐ هماهنگی چنددستگاهی
☐ ویژگی‌های پیشرفته AI
☐ نسخه سخت‌افزاری تجاری

⭐ اگر این پروژه را مفید می‌دانید، لطفاً یک ستاره به آن بدهید!

ساخته شده با ❤️ توسط Leo

«امنیت یک محصول نیست، بلکه یک فرآیند است.» — بروس اشنایر

Name		Name	Last commit message	Last commit date
docs		docs
firmware		firmware
hardware		hardware
web		web
.gitignore		.gitignore
LICENSE		LICENSE
N3XUS.html		N3XUS.html
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

⚡ N3XUS

💬 "Security is not a product, but a process."

🚨 IMPORTANT LEGAL NOTICE

📡 What is N3XUS?

🎯 Why N3XUS?

🚀 Quick Start

📦 Hardware Requirements

💵 Total Estimated Cost: $80–120 (1,500,000 – 2,500,000 IRR)

🔌 Pinout Diagram

🎮 12 Operational Modes

📡 Reconnaissance — Scanning & Discovery

⚔️ Attack — Offensive Operations

🎭 Deception — Social Engineering

🔄 Hybrid — Combined Operations

🖥️ Web Panel Features

📖 Step-by-Step Setup Guide

🛠️ Troubleshooting Guide

📚 Documentation Structure

🔧 Advanced Configuration

🤝 Contributing

📜 License

📬 Contact & Support

👤 Developer

📞 Channels

💖 Support Options

🙏 Acknowledgments

📈 Project Status: Active Development

🚀 Roadmap

⭐ If you find this project useful, please consider giving it a star!

Made with ❤️ by Leo

⚡ N3XUS

💬 «امنیت یک محصول نیست، بلکه یک فرآیند است.»

🚨 اطلاعیه قانونی مهم

📡 N3XUS چیست؟

🎯 چرا N3XUS؟

🚀 شروع سریع

📦 سخت‌افزار موردنیاز

💵 هزینه تقریبی کل: $۸۰–۱۲۰ (۱,۵۰۰,۰۰۰ – ۲,۵۰۰,۰۰۰ تومان)

🎮 ۱۲ حالت عملیاتی

📡 شناسایی — اسکن و کشف

⚔️ حمله — عملیات تهاجمی

🎭 فریب — مهندسی اجتماعی

🔄 ترکیبی — عملیات ترکیبی

🖥️ امکانات پنل وب

🛠️ راهنمای عیب‌یابی

🤝 مشارکت

📜 مجوز

📬 تماس و پشتیبانی

👤 توسعه‌دهنده

📞 کانال‌های ارتباطی

💖 گزینه‌های پشتیبانی

🙏 تشکر و قدردانی

📈 وضعیت پروژه: توسعه فعال

🚀 نقشه راه

⭐ اگر این پروژه را مفید می‌دانید، لطفاً یک ستاره به آن بدهید!

ساخته شده با ❤️ توسط Leo

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages