Name: magisk-wifiadb
Author: mrh929

Overview

Magisk-WiFiADB, developed by mrh929, provides developers and power users with permanent, boot-persistent wireless ADB debugging on stock and custom Android ROMs.

Under standard Android behavior, wireless debugging either toggles off automatically upon reboot, rotates pairing ports randomly (on modern Android versions), or requires tethering the phone via USB cable to run adb tcpip 5555 after every restart. Magisk-WiFiADB eliminates these friction points by managing the ADB daemon at the system property level, keeping TCP debugging consistently listening on your preferred port across reboots.

Prerequisites & Compatibility

Root Solution: Magisk (supports all modern versions).
Network: An active Wi-Fi or LAN connection reachable by the host development computer.
Android Versions: Compatible with stock and custom Android ROMs running Magisk.

There are no documented module conflicts.

How It Operates Under the Hood

The module operates by programmatically managing system properties and the adbd service during the late boot phase:

setprop service.adb.tcp.port <custom_port>
stop adbd
start adbd

By restarting adbd with service.adb.tcp.port bound, the Android ADB daemon listens on all local IP addresses for incoming connections from your workstation.

Configuration & Usage

Basic Connection

Flash the magisk-wifiadb.zip package via Magisk Manager and reboot your device.
Ensure your phone and PC are connected to the same Wi-Fi network.
Locate your phone’s local IP address (in Settings > About Phone > Status or your router’s client table).
From your development PC terminal, connect using the designated port:
```
adb connect 192.168.1.150:1234
```
Confirm the connection and proceed with development commands (adb logcat, adb shell, adb install).
To disconnect:
```
adb disconnect
```

Custom Port & Logging Configuration

To change the default listening port or enable status logging, create a configuration file at /data/adb/modules/magisk-wifiadb/config:

su
cd /data/adb/modules/magisk-wifiadb/
cat << 'EOF' > config
ADB_PORT=5555
ENABLE_LOG=1
STATUS_CHK_FREQUENCY=10
EOF

Configuration Options

Parameter	Accepted Values	Description
`ADB_PORT`	`1`–`65535`	The TCP port number where ADB daemon listens.
`ENABLE_LOG`	`1` (ON) / `0` (OFF)	Enables detailed logging to `/data/local/tmp/wifiadb.log`.
`STATUS_CHK_FREQUENCY`	Integer (`> 0`)	Time interval (seconds) between daemon health checks.

Troubleshooting & Verification

Connection Refused: Verify that the module is toggled ON in the Magisk Manager module list and that your device has fully finished booting. If you accidentally reboot while the module toggle is OFF, the service will not initialize.
Inspecting Module Logs: If unable to connect, read the runtime log directly from the device:
```
cat /data/local/tmp/wifiadb.log
```
Public Wi-Fi Security Warning: Avoid leaving WiFi ADB enabled with predictable ports on public or untrusted Wi-Fi networks, as any device on the local network could attempt to connect to your ADB interface.