███╗ ██╗███████╗██╗ ██╗██╗ ██╗███████╗
████╗ ██║██╔════╝╚██╗██╔╝██║ ██║██╔════╝
██╔██╗ ██║█████╗ ╚███╔╝ ██║ ██║███████╗
██║╚██╗██║██╔══╝ ██╔██╗ ██║ ██║╚════██║
██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║
╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
WiFi Threat Detection • Signal Analysis • Radar
[CYBERPUNK EDITION] [AI-NATIVE BUILD]
🟢 NEON GREEN | AUTHENTIC CYBERPUNK
📡 Advanced WiFi threat detection and signal analysis with real-time sonar, heat maps, and network reconnaissance across Windows, Raspberry Pi, and custom cyberdeck platforms.
Originally built as a room footprint scanner, NEXUS evolved into a full-featured WiFi security analyzer with threat detection, audio sonar feedback, and comprehensive signal visualization during this 72-hour AI …
███╗ ██╗███████╗██╗ ██╗██╗ ██╗███████╗
████╗ ██║██╔════╝╚██╗██╔╝██║ ██║██╔════╝
██╔██╗ ██║█████╗ ╚███╔╝ ██║ ██║███████╗
██║╚██╗██║██╔══╝ ██╔██╗ ██║ ██║╚════██║
██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║
╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
WiFi Threat Detection • Signal Analysis • Radar
[CYBERPUNK EDITION] [AI-NATIVE BUILD]
🟢 NEON GREEN | AUTHENTIC CYBERPUNK
📡 Advanced WiFi threat detection and signal analysis with real-time sonar, heat maps, and network reconnaissance across Windows, Raspberry Pi, and custom cyberdeck platforms.
Originally built as a room footprint scanner, NEXUS evolved into a full-featured WiFi security analyzer with threat detection, audio sonar feedback, and comprehensive signal visualization during this 72-hour AI sprint.
✨ MY FIRST CODING PROJECT - A REAL SUCCESS STORY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎄 BUILT: Christmas Eve → Christmas Day 2025
🤖 PLATFORM: Claude Haiku 4.5 (AI-Assisted Coding)
📝 CODE WRITTEN MANUALLY: ZERO LINES
✅ RESULT: Production-Ready Multi-Platform App
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
My Journey
I thought I "couldn’t code." I had an idea about WiFi scanning. I picked up Claude Haiku 4.5 and started asking questions. 72 hours later, I built a complete WiFi security radar with:
- ✅ Windows GUI application (compiled .exe included)
- ✅ Raspberry Pi optimized version
- ✅ Custom Cyberdeck OS (Bookworm Lite)
- ✅ Threat detection engine
- ✅ Audio sonar feedback
- ✅ Heat map visualization
- ✅ Professional documentation
Zero lines of code written by hand. Everything generated. Everything working.
Why This Matters
This project proved something important to me: You don’t need to be a "traditional programmer" to build real software.
The skill isn’t in typing code. It’s in:
- Having a clear vision
- Communicating your idea clearly
- Iterating on feedback
- Understanding the outcome
I realized the code is just the tool. My vision was the magic.
To Everyone Reading This
If you’re thinking:
- "I’m not a coder"
- "I could never build something like this"
- "Programming is for other people"
Stop. You can do exactly what I did here:
- Pick an AI assistant (Claude, ChatGPT, etc.)
- Describe what you want to build
- Let it generate the code
- Test it, give feedback, iterate
- Ship it
Don’t let anyone convince you that you "can’t code." I proved to myself you can build things. Full things. Professional things. The tooling is there. The knowledge is available. Your only limit is your imagination.
I’m sharing this as a call to action: Try it. Build something. Share it. Inspire someone else.
� SCREENSHOTS & GALLERY
Radar Display - Active Scanning
Real-time WiFi radar with threat indicators, network list, and sonar feedback
Heat Map Visualization - Signal Coverage
Visual heat map showing signal strength distribution across space with overlay analysis
Key UI Elements
-
Top Banner: Active scanning status and theme selector
-
Main Radar: Animated circular display with network positions
-
Network List: Detected WiFi networks with RSSI and threat levels
-
Navigation Tabs: NETWORKS | SECURITY AUDIT | ACTIVITY MONITOR | STATISTICS | VULNERABILITIES | EVENT LOG
-
Status Bar: Real-time threat level, effects toggle, speed controls
-
Color Indicators:
-
🟢 Green = Safe networks
-
🟡 Yellow = Warning level
-
🔴 Red = Critical threats
-
🟣 Magenta = Detected anomalies
🎨 THEME SUPPORT
NEXUS includes multiple cyberpunk themes:
- 🟢 NEON GREEN (Default) - Classic cyberpunk
- 🔵 NEON CYAN - Cool tech aesthetic
- 🟣 NEON PURPLE - Dark cyberpunk
- 🔴 NEON RED - Alert mode
- 💗 NEON PINK - Synthwave style
Press T to cycle through themes in real-time!
NEXUS is a multi-platform WiFi security radar that transforms WiFi signal scanning into actionable intelligence. Using real-time RSSI analysis, it detects threats, visualizes coverage patterns, and provides audio-sonar feedback for continuous network monitoring.
Core Threat Detection
[THREAT_DETECTED] Rogue AP on Channel 6
[ANOMALY] Unknown Device Signature
[ALERT] Network Configuration Vulnerability
[SONAR] ▓▓▓▓░░ Threat Level: 4/10
- WiFi Threat Detection - Identify suspicious networks and unauthorized access points
- Signal Heat Maps - Visualize WiFi coverage and dead zones
- Audio Sonar - Real-time auditory feedback for threats and network events
- Room Footprint Analysis - Auto-detect room boundaries from signal patterns
- Obstacle Detection - Find walls and interference sources
- Network Reconnaissance - Comprehensive WiFi environment analysis
- Multi-Platform - Windows, Raspberry Pi, and custom Cyberdeck OS
🚀 DEPLOYMENT OPTIONS
🪟 WINDOWS EDITION (2 minutes)
[NEXUS] > Download NEXUS-WiFi-Radar.exe
[NEXUS] > Double-Click
[NEXUS] > Scanning...
Pre-compiled executable. No Python. No setup. Pure operation.
# Download and run the EXE from Windows/dist/
# OR run from source:
cd Windows
pip install -r requirements.txt
python nexus-wifi-radar.py
Features:
- ✅ Full-featured GUI
- ✅ Real-time WiFi scanning
- ✅ Threat detection with sonar
- ✅ Signal heat maps
- ✅ CSV data export
→ See Windows/SETUP_GUIDE.md for details
🥧 RASPBERRY PI EDITION (5 minutes)
[NEXUS] > Installation Script Running...
[NEXUS] > System Configuration...
[NEXUS] > Systemd Service Registered
[NEXUS] > Ready for Deployment
Portable WiFi reconnaissance device with USB peripherals.
cd Raspberry-Pi
bash 1-Setup/install.sh
bash 2-Config/configure.sh
bash 3-SystemD/setup-service.sh
python3 nexus-wifi-radar-pi.py
Features:
- ✅ All Windows features (RPi-optimized)
- ✅ USB keyboard/trackpad support
- ✅ Systemd auto-launch on boot
- ✅ WiFi calibration tools
- ✅ System monitoring
- ✅ Remote SSH access
→ See Raspberry-Pi/QUICKSTART.md
🖥️ NEXUS CYBERDECK (45 minutes)
[NEXUS] > Building Custom OS...
[NEXUS] > Installing System Services...
[NEXUS] > Configuring Audio Sonar...
[NEXUS] > CYBERDECK READY
[NEXUS] > Auto-Launch on Boot: ENABLED
Standalone WiFi security device with custom Debian OS and full system integration.
# Follow the complete cyberdeck build guide:
# See: Docs/CYBERDECK_FULL_GUIDE.md
Features:
- ✅ Custom Bookworm Lite OS (~2GB)
- ✅ Auto-launching NEXUS on boot
- ✅ Professional audio sonar integration
- ✅ Customizable themes & wallpapers
- ✅ Full system logging & monitoring
- ✅ Minimal footprint, maximum functionality
→ See Docs/CYBERDECK_FULL_GUIDE.md
� PLATFORM COMPARISON
┌──────────────────┬──────────┬──────────┬────────────┐
│ METRIC │ WINDOWS │ RPi │ CYBERDECK │
├──────────────────┼──────────┼──────────┼────────────┤
│ Setup Time │ 2 min │ 5 min │ 45 min │
│ Cost │ FREE │ ~$100 │ ~$200-400 │
│ Portability │ 💻 Good │ 📦 Great │ 🎮 Extreme │
│ Auto-Launch │ ❌ No │ ✅ Yes │ ✅ Yes │
│ Audio Sonar │ ✅ Yes │ ✅ Yes │ ✅ Yes │
│ Standalone │ ❌ No │ ✅ Yes │ ✅ Full │
│ Customization │ Limited │ Moderate │ Extensive │
│ Ease of Use │ ⭐⭐⭐⭐⭐ │ ⭐⭐⭐⭐ │ ⭐⭐⭐⭐ │
└──────────────────┴──────────┴──────────┴────────────┘
📂 REPOSITORY STRUCTURE
NEXUS-WiFi-Radar/
│
├─ 🪟 Windows/
│ ├─ nexus-wifi-radar.py ............. Source Code
│ ├─ dist/NEXUS-WiFi-Radar.exe ....... Compiled EXE
│ ├─ SETUP_GUIDE.md .................. Installation
│ └─ requirements.txt ................ Dependencies
│
├─ 🥧 Raspberry-Pi/
│ ├─ nexus-wifi-radar-pi.py .......... Source Code
│ ├─ QUICKSTART.md ................... Quick Start
│ ├─ SETUP_GUIDE.md .................. Full Setup
│ ├─ 1-Setup/ ........................ Install Scripts
│ ├─ 2-Config/ ....................... Config Tools
│ ├─ 3-SystemD/ ...................... Service Files
│ └─ 4-Utils/ ........................ Calibration Tools
│
├─ 📚 Docs/
│ ├─ CYBERDECK_FULL_GUIDE.md ......... OS Build Guide
│ ├─ HARDWARE_SETUP.md ............... Wiring & Config
│ ├─ DEPLOYMENT_CHECKLIST.md ........ Pre-Deploy Steps
│ ├─ QUICK_REFERENCE.md ............. Command Reference
│ └─ README.md ....................... RPi Overview
│
└─ 📦 Release/
└─ v1.0/ ........................... Previous Releases
🎮 CORE FEATURES
WiFi THREAT DETECTION
[SCAN] 47 Networks Found
[SCAN] 892 Devices Detected
[THREAT] 3 Rogue Access Points Identified
[ALERT] 2 Networks with Configuration Vulnerabilities
[SONAR] ▓▓▓▓▓░░░░░ Threat Level: 5/10
SIGNAL VISUALIZATION
HEATMAP VIEW:
┌─────────────────────────────────┐
│ ░░▒▒▓▓██████▓▓▒▒░░░░░░░░░░░░ │ -45dBm
│ ░░░░▒▒▓▓█████▓▓▒▒░░░░░░░░░░░ │ -50dBm
│ ░░░░░░▒▒▓▓███▓▓▒▒░░░░░░░░░░░ │ -55dBm
│ ░░░░░░░░▒▒▓▓█▓▓▒▒░░░░░░░░░░░ │ -60dBm
└─────────────────────────────────┘
AUDIO SONAR
- 🔊 Real-time threat alerts
- 📈 Signal strength audification
- ⚠️ Critical event notifications
- 🎵 Network presence tones
🔧 QUICK REFERENCE
Windows
python nexus-wifi-radar.py
Raspberry Pi
python3 nexus-wifi-radar-pi.py
systemctl status nexus-scanner # Check service
journalctl -u nexus-scanner -f # View logs
Cyberdeck
systemctl start nexus-scanner # Start service
systemctl stop nexus-scanner # Stop service
journalctl -u nexus-scanner -f # View logs
NEXUS-WiFi-Radar/
│
├── 🪟 Windows/ Windows GUI application
│ ├── nexus-wifi-radar.py Main source code
│ ├── dist/NEXUS-WiFi-Radar.exe Compiled executable (no Python needed)
│ ├── SETUP_GUIDE.md Windows installation guide
│ └── requirements.txt Python dependencies
│
├── 🥧 Raspberry-Pi/ Raspberry Pi optimized version
│ ├── nexus-wifi-radar-pi.py RPi source code
│ ├── QUICKSTART.md Quick start guide
│ ├── SETUP_GUIDE.md Detailed setup guide
│ ├── 1-Setup/ Installation scripts
│ ├── 2-Config/ Configuration utilities
│ ├── 3-SystemD/ Systemd service files
│ └── 4-Utils/ Calibration & monitoring tools
│
├── 🖥️ Docs/ Comprehensive documentation
│ ├── CYBERDECK_FULL_GUIDE.md Build custom OS (Bookworm Lite)
│ ├── HARDWARE_SETUP.md Hardware wiring & configuration
│ ├── DEPLOYMENT_CHECKLIST.md Deployment verification steps
│ ├── QUICK_REFERENCE.md Command reference
│ └── README.md RPi edition overview
│
└── Release/ Packaged releases
└── v1.0/ Previous stable releases
🎮 What Each Version Does
Windows Edition
✅ Full-featured GUI application ✅ Real-time WiFi scanning ✅ Threat detection with sonar ✅ Signal heat maps ✅ Pre-compiled EXE (no setup needed) ✅ CSV data export
Best for: Desktop security testing, WiFi site surveys, network analysis on Windows PCs
Raspberry Pi Edition
✅ All Windows features, RPi-optimized ✅ USB keyboard/trackpad support ✅ Systemd auto-launch ✅ WiFi calibration tools ✅ System monitoring ✅ SSH remote access
Best for: Portable WiFi scanning device, home network monitoring, field testing
NEXUS Cyberdeck
✅ Custom Debian-based OS (Bookworm Lite) ✅ Full system integration ✅ Auto-launching NEXUS on boot ✅ Audio sonar with ALSA ✅ Customizable themes & wallpapers ✅ Minimal footprint (~2GB)
Best for: Standalone security device, portable professional toolkit, cyberpunk aesthetics
⚠️ LEGAL & ETHICAL
Authorized Use:
- ✅ Test networks you own or have permission for
- ✅ Educational security analysis
- ✅ WiFi optimization and planning
- ✅ Home network monitoring
Prohibited Use:
- ❌ Unauthorized network access
- ❌ Network scanning without consent
- ❌ Illegal surveillance
- ❌ Any unlawful activity
Use responsibly. You are responsible for compliance with all applicable laws.
📝 LICENSE
MIT License - See LICENSE file for details.
This software is provided for educational and authorized testing only.
Users are responsible for ensuring all use complies with applicable laws.
Developers are not responsible for misuse of this software.
📞 SUPPORT
[?] Documentation: See Docs/ folder
[?] Quick Start: See QUICKSTART.md files
[?] Issues: Open an Issue on GitHub
[?] Questions: Check QUICK_REFERENCE.md
🎓 FINAL THOUGHT
This project was built to prove something important: You can build real, professional software without being a "traditional programmer."
The only thing between your idea and a deployed product is:
- Clear communication
- An AI assistant
- Willingness to iterate
If you’re reading this and thinking "I could never do that" — yes, you can.
Start today. Build something. Change someone’s mind.
Built with 🖥️💻⚡ over Christmas
Made possible by AI-assisted development
Designed for cybersecurity enthusiasts, network engineers,
and anyone who believes they can't code (yet).
You can. Go build something.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Last Updated: December 25, 2025
Status: PRODUCTION READY
Next Update: When you decide to build version 2.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🟢 **NEXUS ACTIVE. SCANNING. READY FOR DEPLOYMENT.** 🟢
---
## 🎓 Credits
Built with 🖥️💻⚡ for cybersecurity enthusiasts, network engineers, IoT security professionals, and anyone who thinks they can't code (because they can).
**Last Updated**: December 2025
---
**Ready to analyze WiFi? Pick your platform above and get started! 🚀**
*And if you build something cool with AI, share it - you might inspire someone else like this project inspired me.*