⚡ WirelessADB

  ██╗    ██╗██╗██████╗ ███████╗██╗     ███████╗███████╗███████╗     █████╗ ██████╗ ██████╗ 
  ██║    ██║██║██╔══██╗██╔════╝██║     ██╔════╝██╔════╝██╔════╝    ██╔══██╗██╔══██╗██╔══██╗
  ██║ █╗ ██║██║██████╔╝█████╗  ██║     █████╗  ███████╗███████╗    ███████║██║  ██║██████╔╝
  ██║███╗██║██║██╔══██╗██╔══╝  ██║     ██╔══╝  ╚════██║╚════██║    ██╔══██║██║  ██║██╔══██╗
  ╚███╔███╔╝██║██║  ██║███████╗███████╗███████╗███████║███████║    ██║  ██║██████╔╝██████╔╝
   ╚══╝╚══╝ ╚═╝╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚══════╝╚══════╝    ╚═╝  ╚═╝╚═════╝ ╚═════╝

The Next-Gen Wireless Android Debugging & Telemetry Suite

Cut the cables. Stay secure. Debug at lightspeed. 🚀🔥

Key Features • Quick Install • Interactive TUI • Architecture • Security • Command Reference

💡 Why WirelessADB?

Vanilla adb tcpip 5555 is painful, slow, and insecure:

💀 Fixed Port 5555: A massive neon sign for LAN port scanners and malware.
🔌 Tethered Hell: Endless plugging/unplugging cables just to fetch your IP.
👻 Ghost Disconnects: Wi-Fi blips kill your session with zero auto-recovery.
💤 Zero Telemetry: No clue about battery percentage, network latency, or link speed.

🔥 Enter WirelessADB

WirelessADB transforms ADB into a high-octane, interactive developer console. It automates random high-port negotiation (30000–50000), enables Android 11+ zero-wire Wi-Fi pairing, monitors live device telemetry, launches 60 FPS scrcpy mirroring in 1 keystroke, and auto-heals dropped connections in the background.

⚡ Comparison: Vanilla ADB vs WirelessADB

Feature	🚫 Vanilla `adb`	⚡ WirelessADB Suite
Port Security	Hardcoded `5555` (Known CVE target)	Dynamic High-Port (30000–50000) 🛡️
Android 11+ Zero-Cable Pairing	Manual multi-step PIN CLI	One-Step Guided Wizard (`pair`) 📱
Interactive Terminal Menu	❌ None	Full Cyberpunk TUI Dashboard (`menu`) 🎨
Auto-Reconnect Watcher	❌ Manual retry	Background Daemon Auto-Heal (`watch`) 🔄
Live Battery & Thermal Meters	❌ None	Real-time % / State / Temp HUD 🔋
Network Latency & Signal RSSI	❌ None	Live Ping (ms) & Subnet Guard 📶
One-Click Screen Mirror	❌ Manual scrcpy flags	Optimized 60 FPS Screen Mirror (`mirror`) 🖥️
Subnet Mismatch Alert	❌ Silent failure	Automatic VLAN / Subnet Check ⚠️
Zero Dependencies	N/A	100% Pure Python Standard Library 📦

🚀 One-Line Install

🪟 Windows (PowerShell — Recommended)

irm https://raw.githubusercontent.com/taezeem14/WirelessADB/main/install.ps1 | iex

Tip: If the above gives a Path error, use the explicit scriptblock pattern:
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/taezeem14/WirelessADB/main/install.ps1)))

Or in Command Prompt (CMD):

curl -fsSL https://raw.githubusercontent.com/taezeem14/WirelessADB/main/install_windows.bat -o install.bat && install.bat

🐧 Linux (Bash / Zsh)

curl -fsSL https://raw.githubusercontent.com/taezeem14/WirelessADB/main/install_linux.sh | bash

🍏 macOS (Homebrew / Terminal)

curl -fsSL https://raw.githubusercontent.com/taezeem14/WirelessADB/main/install_macos.sh | bash

🐍 Pip / Pipx

pip install git+https://github.com/taezeem14/WirelessADB.git

🎮 Interactive TUI & CLI Showcase

Launch the interactive control center anytime by simply typing:

wireless-adb
# or using the ultra-fast alias:
wadb

╭─ ⚡ WIRELESS ADB CONTROL CENTER ────────────────────────────────╮
│ Status: 1 Wireless | 0 USB                                     │
│                                                                │
│   [1] ⚡ Connect USB Device to Wireless (Auto High-Port)        │
│   [2] 📱 Pair via Android 11+ Wi-Fi (No Cable Needed)          │
│   [3] 📊 Show Live Status Dashboard & Latency                  │
│   [4] 🔄 Quick Reconnect to Last Device                        │
│   [5] 🔍 Deep Device Telemetry (Battery, CPU, Wi-Fi)           │
│   [6] 🚀 Launch scrcpy Screen Mirror                           │
│   [7] 💻 Open Wireless Terminal Shell                          │
│   [8] 📡 Scan Network for ADB Devices                          │
│   [9] 🩺 Run Doctor Health Diagnostics                         │
│   [0] 🔌 Disconnect & Clean Up All Sessions                    │
│   [q] 🚪 Quit                                                  │
╰────────────────────────────────────────────────────────────────╯

🏗️ System Architecture

graph TD
    subgraph Host ["💻 Developer Workstation"]
        CLI["⚡ WirelessADB Core Engine (CLI/TUI)"]
        CONF[("📁 ~/.wireless_adb/profiles.json")]
        WATCH["👁️ Watcher Daemon (Auto-Heal)"]
        SCRCPY["🚀 scrcpy 60FPS Video Engine"]
        ADBC["ADB Client / Server"]
    end

    subgraph Transport ["🛡️ Security & Transport Layer"]
        USB["🔌 USB Physical Bridge (Initial Auth)"]
        WIFI["📡 Wi-Fi 802.11ax / 5GHz (TCP/IP High Port)"]
        MDNS["🔍 mDNS Zeroconf Discovery"]
    end

    subgraph Target ["📱 Android Target Device"]
        ADBD["adbd (Daemon Service)"]
        PROP["System Telemetry (Battery / WiFi / Thermal)"]
        A11["Android 11+ Pairing Manager"]
    end

    CLI -->|Read/Write| CONF
    CLI -->|Manage Sessions| ADBC
    WATCH -->|Heartbeat Ping| ADBC
    CLI -->|Stream Mirror| SCRCPY
    
    ADBC -->|Initial Handshake| USB
    ADBC -->|High-Port 30000-50000| WIFI
    ADBC -->|Zero-Wire Pair PIN| MDNS

    USB --> ADBD
    WIFI --> ADBD
    MDNS --> A11
    ADBD --> PROP

🔄 Connection Workflows

1. Standard USB-to-Wireless Auto-Handshake

sequenceDiagram
    autonumber
    actor Dev as 👨‍💻 Developer
    participant WADB as ⚡ WirelessADB
    participant Host as 💻 ADB Host
    participant Phone as 📱 Android Device

    Dev->>WADB: Runs 'wireless-adb connect'
    WADB->>Host: Query USB devices ('adb devices -l')
    Host-->>WADB: Returns Serial & Model Name
    WADB->>Phone: Probe Wi-Fi IP ('ip addr show wlan0')
    Phone-->>WADB: 192.168.1.145
    WADB->>WADB: Generate random high port (e.g. 43891)
    WADB->>Phone: 'adb tcpip 43891'
    Phone-->>WADB: TCP/IP Port Opened
    WADB->>Host: 'adb connect 192.168.1.145:43891'
    Host-->>WADB: Handshake Connected!
    WADB->>Dev: 🎉 "Unplug USB Cable! Device is Wireless"

2. Android 11+ Zero-Cable Wi-Fi Pairing

sequenceDiagram
    autonumber
    actor Dev as 👨‍💻 Developer
    participant Phone as 📱 Android (Dev Options)
    participant WADB as ⚡ WirelessADB

    Dev->>Phone: Enable "Wireless Debugging" -> "Pair with code"
    Phone-->>Dev: Displays 192.168.1.145:37281 & PIN: 849201
    Dev->>WADB: 'wireless-adb pair'
    WADB->>Phone: 'adb pair 192.168.1.145:37281 849201'
    Phone-->>WADB: Handshake authenticated & RSA key stored
    WADB->>Phone: 'adb connect 192.168.1.145:PORT'
    WADB->>Dev: ✨ Zero-Wire Wireless Session Live!

📋 Command Matrix

Command	Shorthand	Description
`wireless-adb`	`wadb`	Launch full interactive TUI Control Center.
`wireless-adb connect`	`wadb connect`	Switch USB device to secure high-port wireless mode.
`wireless-adb pair`	`wadb pair`	Android 11+ zero-wire Wi-Fi pairing wizard.
`wireless-adb status`	`wadb status`	Live dashboard with latency pings and battery meters.
`wireless-adb reconnect`	`wadb reconnect`	Reconnect instantly to last known device.
`wireless-adb info`	`wadb info`	Deep device telemetry (RAM, CPU ABI, battery %, WiFi RSSI).
`wireless-adb mirror`	`wadb mirror`	Instant 60 FPS low-latency screen mirror via `scrcpy`.
`wireless-adb shell`	`wadb shell`	Direct interactive wireless terminal shell.
`wireless-adb install <apk>`	`wadb install`	Wireless fast APK installer.
`wireless-adb scan`	`wadb scan`	Scan local subnet and mDNS for active ADB endpoints.
`wireless-adb watch`	`wadb watch`	Run auto-reconnection daemon for dropped Wi-Fi sessions.
`wireless-adb doctor`	`wadb doctor`	Pre-flight diagnostics (ADB, Python, PATH, permissions).
`wireless-adb disconnect`	`wadb disconnect`	Disconnect all wireless sessions and reset to USB mode.

🔒 Security-First Architecture

Wireless ADB inherently exposes a shell port over your local Wi-Fi. WirelessADB implements defense-in-depth:

 ┌─────────────────────────────────────────────────────────────┐
 │               WIRELESSADB SECURITY SHIELD                   │
 ├─────────────────────────────────────────────────────────────┤
 │  🛡️ Dynamic Port Obfuscation : Random 30000-50000 range      │
 │  🛡️ Subnet Isolation Guard  : Detects cross-VLAN leaks      │
 │  🛡️ Zero-Residual Disconnect: Hard TCP reset to USB-only     │
 │  🛡️ Ephemeral RSA Pairing   : Full Android 11 TLS crypt     │
 └─────────────────────────────────────────────────────────────┘

Port Obfuscation: Eliminates default port 5555, preventing automated mass-scanners on coffee shop / office Wi-Fi from detecting your device.
Subnet Verification: Checks both host IPv4 and device IPv4 masks to warn if your device is inadvertently exposed to an unexpected subnet or public interface.
Clean Teardown: wireless-adb disconnect resets the phone's daemon back to USB-only mode, closing any listening TCP sockets.

🧪 Developer Recipes

⚛️ React Native & Expo

# Connect wirelessly, then start Metro bundler
wireless-adb connect
npx react-native run-android

💙 Flutter

wireless-adb connect
flutter run -d $(wireless-adb status | grep -oE '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+:[0-9]+')

📱 Android Studio

Once connected with wireless-adb connect, Android Studio will instantly detect your device in the Running Devices / Target Device dropdown!

🤝 Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/EpicFeature)
Commit your Changes (git commit -m 'feat: Add EpicFeature')
Push to the Branch (git push origin feature/EpicFeature)
Open a Pull Request

📜 License & Credits

Distributed under the MIT License. See LICENSE for more information.

Crafted with ❤️ by Muhammad Taezeem Tariq.
If you like this project, please consider giving it a ⭐ on GitHub!

Name		Name	Last commit message	Last commit date
.gitignore		.gitignore
EXAMPLES.md		EXAMPLES.md
LICENSE		LICENSE
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
QUICKSTART.md		QUICKSTART.md
README.md		README.md
SECURITY.md		SECURITY.md
install.ps1		install.ps1
install_linux.sh		install_linux.sh
install_macos.sh		install_macos.sh
install_windows.bat		install_windows.bat
pyproject.toml		pyproject.toml
setup.py		setup.py
wireless_adb.py		wireless_adb.py

Navigation Menu

Repository files navigation

⚡ WirelessADB

The Next-Gen Wireless Android Debugging & Telemetry Suite

💡 Why WirelessADB?

🔥 Enter WirelessADB

⚡ Comparison: Vanilla ADB vs WirelessADB

🚀 One-Line Install

🪟 Windows (PowerShell — Recommended)

🐧 Linux (Bash / Zsh)

🍏 macOS (Homebrew / Terminal)

🐍 Pip / Pipx

🎮 Interactive TUI & CLI Showcase

🏗️ System Architecture

🔄 Connection Workflows

1. Standard USB-to-Wireless Auto-Handshake

2. Android 11+ Zero-Cable Wi-Fi Pairing

📋 Command Matrix

🔒 Security-First Architecture

🧪 Developer Recipes

⚛️ React Native & Expo

💙 Flutter

📱 Android Studio

🤝 Contributing

📜 License & Credits

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

⚡ WirelessADB

The Next-Gen Wireless Android Debugging & Telemetry Suite

💡 Why WirelessADB?

🔥 Enter WirelessADB

⚡ Comparison: Vanilla ADB vs WirelessADB

🚀 One-Line Install

🪟 Windows (PowerShell — Recommended)

🐧 Linux (Bash / Zsh)

🍏 macOS (Homebrew / Terminal)

🐍 Pip / Pipx

🎮 Interactive TUI & CLI Showcase

🏗️ System Architecture

🔄 Connection Workflows

1. Standard USB-to-Wireless Auto-Handshake

2. Android 11+ Zero-Cable Wi-Fi Pairing

📋 Command Matrix

🔒 Security-First Architecture

🧪 Developer Recipes

⚛️ React Native & Expo

💙 Flutter

📱 Android Studio

🤝 Contributing

📜 License & Credits

About

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages