Skip to content

Wireless Debugging Setup

Jump to bottom
Hridayan edited this page Jan 14, 2026 · 23 revisions

Important

  • Your device must be running Android 11 or above
  • A Wi-Fi connection is required - internet is not necessary

Warning

It is advisable to turn off Wireless Debugging when not in use

Caution

Basic knowledge of ADB commands is required


Wireless Debugging Location

  1. Go to developer options and look for Wireless debugging.
  2. Tab on the Wireless debugging option to open the pairing menu.

Choose the target device type

  1. Click on Pair button in aShell You homescreen to popup target device type selector dialog.
  2. After selecting the device type, proceed as follows:

Own device as target

  1. Grant Notification access to aShell You.

Notification access is mandatory to enter the pairing code to connect the device.

  1. Click on the Developer Options button shown in the Instructions section.
  2. Click on Wireless Debugging.
  3. Click on Pair device using qr code

Connect to Another Device

  1. Connect both devices to the same Wi-Fi network.

  2. Turn on Developer Options on the target device.

  3. Go to the Wireless Debugging section on the target device. View screenshot

  4. Tap on "Pair with Pairing Code". View screenshot

  5. Enter the IP, Port, and Pairing Code in the bottom sheet input fields on the host device. View screenshot

  6. After successful pairing, enter the port as shown in the screenshots. Tap "Connect". View screenshot

  7. After successful connection, run ADB commands from the host device!


Connect Self Device

  1. Connect your device to a Wi-Fi network.
  2. When you click "Connect this device", you will see a notification requesting the pairing code.
  3. Enable Developer Options on your device.
  4. Navigate to Developer options > Wireless Debugging.
  5. Tap "Pair with Pairing Code".
  6. Enter the Pairing Code from the notification sent by aShellYou.
  7. Submit the notification, and you will see a Success message.
  8. Go to aShell You, tap the Wireless Debugging card, select the connected device, and run your commands.

Troubleshooting

If you face any issues while setting up wireless debugging, please check the following:

  • Ensure both devices are connected to the same Wi-Fi network.
  • If the Wi-Fi network has no internet connection, then turn off mobile data as well for better Wi-Fi connection.
  • Restart the devices if necessary and reattempt the pairing.

If you run into any issues or want to ask questions, feel free to:

Clone this wiki locally