feat: add Wi-Fi ADB connection helpers

Author: PixelCode01

README.md

@@ -1,6 +1,6 @@
 # Android Bloatware Remover
 
-Remove unwanted pre-installed apps from your Android phone without root access. Works with Samsung, Xiaomi, Oppo, Vivo, Realme, Tecno, and OnePlus devices.
+Remove unwanted pre-installed apps from your Android phone without root access. Works with Samsung, Xiaomi, Oppo, Vivo, Realme, Tecno, OnePlus, Huawei, Honor, Motorola, and Nothing devices.
 
 ## What it does
 
@@ -101,6 +101,14 @@ You'll get four options:
 3. **Manual mode** - Type a package name (`com.android.chrome`) or search by app name (`chrome`)
 4. **Batch mode** - Removes all known bloatware at once (be careful!)
 
+### Connecting over Wi-Fi
+
+- Start the tool with Wi-Fi prompts: `python main.py --wifi`
+- Provide everything non-interactively with `--wifi-endpoint`, `--wifi-pair`, and `--wifi-code`
+- Enable wireless debugging on a cabled device using `python main.py --enable-tcpip`
+
+See [WIFI_ADB_GUIDE.md](WIFI_ADB_GUIDE.md) for a complete walk-through, pairing reminders, and troubleshooting tips.
+
 ## Safety features
 
 - **Risk levels**: Apps marked as SAFE, CAUTION, or DANGEROUS

WIFI_ADB_GUIDE.md

@@ -0,0 +1,55 @@
+# Wi-Fi ADB Guide
+
+Use Wi-Fi debugging when a cable is unreliable or you want to keep the device untethered while removing apps. Follow the steps below from top to bottom.
+
+## Prerequisites
+
+- Android 11 or newer with Developer Options unlocked
+- Phone and computer on the same Wi-Fi network
+- USB cable for the first pairing (only needed once per network)
+- Android Platform Tools (adb) available on your computer or the packaged copy shipped with this project
+
+## Enable Developer Options and Wi-Fi debugging
+
+1. Connect the phone with USB and run `adb devices` once to confirm debugging is allowed. Accept the prompt on the device.
+2. Open **Settings → Developer options**.
+3. Turn on **Wireless debugging**. If the option is greyed out, toggle USB debugging off and on first.
+4. Tap **Wireless debugging → Pair device with pairing code**. Leave this screen open.
+
+## Pair the device
+
+1. Run the tool with the new Wi-Fi helpers:
+   ```powershell
+   python main.py --wifi
+   ```
+   The program prompts for the IP address and pairing code.
+2. Enter the pairing IP and port shown on the phone.
+3. Enter the six-digit pairing code. A confirmation message appears if pairing succeeds.
+
+You can also provide everything up front:
+```powershell
+python main.py --wifi-endpoint 192.168.0.42:5555 --wifi-pair 192.168.0.42:38921 --wifi-code 123456
+```
+
+## Reconnect later without a cable
+
+Once paired, enable TCP/IP on the device whenever you plug in a cable:
+```powershell
+python main.py --enable-tcpip --tcpip-port 5555
+```
+
+Then unplug the cable and connect over Wi-Fi:
+```powershell
+python main.py --wifi-endpoint 192.168.0.42:5555
+```
+
+If you forgot the endpoint, run `adb devices -l` to list active wireless sessions.
+
+## Troubleshooting
+
+- **Device not found**: verify both devices share the same network, or disable VPNs and private DNS.
+- **Pairing fails immediately**: pairing codes expire after about thirty seconds; request a new one before retrying.
+- **Commands are slow**: keep the screen awake and close heavy network traffic apps; 5 GHz Wi-Fi is more stable than 2.4 GHz.
+- **Need to reset**: disable Wireless debugging in Developer Options, re-enable it, and pair again.
+
+After a successful Wi-Fi connection you can follow the normal removal workflow. Test mode continues to work with the `--test` flag even when Wi-Fi debugging is active.

core/adb_utils.py

@@ -11,9 +11,11 @@
 import zipfile
 from dataclasses import dataclass
 from pathlib import Path
+import re
 from typing import Iterable, List, Optional
 
 DEFAULT_TIMEOUT = 15
+DEFAULT_TCPIP_PORT = 5555
 
 
 @dataclass
@@ -328,12 +330,124 @@ def find_authorized_device(
     "ADBError",
     "ADBNotFoundError",
     "DEFAULT_TIMEOUT",
+    "DEFAULT_TCPIP_PORT",
     "DeviceSelectionError",
     "DeviceState",
+    "activate_tcpip_mode",
+    "connect_wifi_device",
+    "disconnect_device",
     "find_authorized_device",
+    "is_wifi_serial",
     "list_devices",
     "parse_devices_output",
+    "pair_device",
     "resolve_adb_path",
     "run_command",
     "start_server",
 ]
+
+
+WIFI_SERIAL_PATTERN = re.compile(r"^[\w.-]+:\d+$")
+
+
+def is_wifi_serial(serial: str) -> bool:
+    """Return True when the serial refers to a network-connected device."""
+
+    if not serial:
+        return False
+    if serial.startswith("emulator-"):
+        return False
+    return bool(WIFI_SERIAL_PATTERN.match(serial))
+
+
+def activate_tcpip_mode(
+    adb_path: str,
+    *,
+    device_serial: Optional[str] = None,
+    port: int = DEFAULT_TCPIP_PORT,
+    timeout: int = DEFAULT_TIMEOUT,
+) -> None:
+    """Ask a connected device to listen for TCP/IP debugging connections."""
+
+    run_command(
+        adb_path,
+        ["tcpip", str(port)],
+        device_serial=device_serial,
+        timeout=timeout,
+        check=True,
+    )
+
+
+def pair_device(
+    adb_path: str,
+    host_with_port: str,
+    pairing_code: str,
+    *,
+    timeout: int = DEFAULT_TIMEOUT,
+) -> None:
+    """Pair with a device over Wi-Fi using the provided pairing code."""
+
+    result = run_command(
+        adb_path,
+        ["pair", host_with_port, pairing_code],
+        timeout=timeout,
+        check=False,
+    )
+
+    if result.returncode != 0:
+        raise ADBCommandError(
+            "Failed to pair with Wi-Fi device",
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+
+
+def connect_wifi_device(
+    adb_path: str,
+    host_with_port: str,
+    *,
+    timeout: int = DEFAULT_TIMEOUT,
+) -> DeviceState:
+    """Connect to a Wi-Fi adb endpoint and return the resulting device state."""
+
+    result = run_command(
+        adb_path,
+        ["connect", host_with_port],
+        timeout=timeout,
+        check=False,
+    )
+
+    if result.returncode != 0:
+        raise ADBCommandError(
+            "Failed to connect to Wi-Fi device",
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+
+    refreshed = list_devices(adb_path, timeout=timeout)
+    for device in refreshed:
+        if device.serial == host_with_port:
+            return device
+
+    raise DeviceSelectionError(
+        "Connected to Wi-Fi device but it did not appear in the device list",
+        devices=refreshed,
+    )
+
+
+def disconnect_device(
+    adb_path: str,
+    host_with_port: str,
+    *,
+    timeout: int = DEFAULT_TIMEOUT,
+) -> None:
+    """Disconnect a specific adb endpoint."""
+
+    run_command(
+        adb_path,
+        ["disconnect", host_with_port],
+        timeout=timeout,
+        check=False,
+    )