← Manual

04 Wireless ADB

04 Wireless ADB

Wireless debugging needs Android 11 or newer on a phone, both devices on the same Wi-Fi network, and the latest Android SDK Platform Tools on the computer. Google documents the whole procedure at developer.android.com/tools/adb.

Wireless ADB is how the desktop companion reaches a phone without a cable, and it is also how the desktop pulls a file off a phone. The Android app itself does not use Shizuku, all-files access or root; it reads only the folder you grant it (chapter 08).

The one thing people get wrong

Pairing and connecting use two different ports.

If you reuse the pairing port to connect, the connection fails. Google's steps are: pair with adb pair ipaddr:port using the pairing-code screen's port, then connect; after the first pairing the device and computer reconnect automatically on the same network (developer.android.com/tools/adb).

Step 1 - Turn wireless debugging on

  1. Enable Developer options (chapter 03).
  2. Open Settings > System > Developer options > Wireless debugging and turn it on. On Android 16 and later Google documents the path as Settings > System > Developer options > Wireless debugging (developer.android.com/studio/debug/dev-options).
  3. Allow wireless debugging on this network when asked.

What you should see: a screen with "Paired devices" at the top and an "IP address & Port" line below it.

Step 2 - Pair

  1. On the phone, tap "Pair device with pairing code".
  2. Read the address and the six-digit code from that screen.
  3. In the companion, open the Phone (ADB) tab, find the Wireless ADB section, and type the address into "Pairing address host:port" and the code into "6-digit code". Press Pair.

What you should see: on the phone, "Paired devices" gains an entry named after your computer. On the computer, a success message. If the code expires (the dialog stays open only briefly), close it and reopen it for a fresh code.

Step 3 - Connect

  1. On the phone, close the pairing dialog and read the "IP address & Port" line on the main Wireless debugging screen.
  2. In the same Wireless ADB section, type it into "Connect address host:port (the main wireless port)" and press Connect. Discover is there if you would rather let the companion find the phone on the network.

What you should see: the phone in the device list, in the same way a USB connection appears.

Note on Android 10 and older: there is no wireless-debugging screen at all. The only path is adb tcpip 5555 over an initial USB connection, then adb connect ip:5555 (developer.android.com/tools/adb).

Step 4 - Keeping it connected

Troubleshooting wireless connections

Symptom What to check
Connect fails right after a successful pair You used the pairing port for the connect step. Use the port on the main Wireless debugging screen
Phoneless "no devices" but pairing succeeded Both devices must be on the same network and the same subnet. Guest Wi-Fi networks often isolate clients
Worked yesterday, nothing today The phone rebooted or the port changed. Re-read the port on the phone and reconnect
VPN on the computer Turn the VPN off for the recovery session. A VPN can hide the phone's mDNS advertisements
Router with client isolation or "AP isolation" Disable it, or fall back to USB
Discover finds nothing mDNS is blocked on that network. Type the address shown on the phone instead, or switch to USB for this session
Very old platform tools Update to the latest Platform Tools; older adb builds handle wireless debugging poorly (developer.android.com/tools/releases/platform-tools)

Wireless debugging and this app's storage

Wireless debugging does not widen what the Android app can read: it is a transport for adb, and the app keeps using the folder you granted. If you were hoping to reach the Gallery recycle bin or Android/data/, chapter 08 explains why this app does not attempt either, and why no access tier makes deleted file data readable.