Skip to content

Wireless Debugging Setup

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 pairing code
  4. Enter the 6-digit pairing code in the notification sent by ashell You.
  5. After successfull connection, you will see your device with connected status. Click on the Go to terminal button to navigate to the shell terminal screen.

Another device as target

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

On the host device (device with aShell You):

  1. Choose one pairing mode, either Pair using qr or Pair using pairing code.
  2. Wait for target device to initiate pairing process.

In QR mode, when target device scans the qr code, the device will be successfully connected without any other input from user.

In Pair using pairing code mode, when the target device opens the pairing code dialog, the target device will be shown in app ui and you have to enter the pairing code in the input field as such.

On the target device:

  1. Turn on Developer Options.
  2. Click on the Wireless debugging section.
  3. Choose a method to pair.

For QR pairing, scan the QR code shown in aShell You using the QR scanner available at Pair device using QR code option.

For Pairing using pairing code, open the Pairing code dialog available at Pair using pairing code option.


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.

Clone this wiki locally