Async

To utilize the async version of this code, you must install into a Python 3.7+ environment via:

pip install adb-shell-wifi[async]

USB Support (Experimental)

To connect to a device via USB, install this package via:

pip install adb-shell-wifi[usb]

Wi-Fi Pairing Support (Experimental)

To pair with a modern Android device using a 6-digit pairing code (Android 11+ “Wireless debugging”), install this package via:

pip install adb-shell-wifi[wifi]

This pulls in spake2-cffi and pyOpenSSL. Note: spake2-cffi does not publish Windows wheels, so Windows users will need a C toolchain available at install time.

On the device, open Settings > System > Developer options > Wireless debugging > Pair device with pairing code. Note the IP address, port, and 6-digit code shown by the device, then:

from adb_shell_wifi.pairing import pair

adbkey = "path/to/adbkey"
with open(adbkey, "rb") as f:
    priv = f.read()
with open(adbkey + ".pub", "rb") as f:
    pub = f.read()

peer_info = pair(
    host="192.168.1.42",   # from device UI
    port=43811,            # from device UI
    pairing_code="515109", # from device UI
    private_key_pem=priv,
    public_key=pub,
)
print("device peer info:", peer_info.type, peer_info.data)

After pairing succeeds, the device records the host’s public key in its keystore. To actually run shell commands, push, pull, etc. over the post-pairing TLS channel, use AdbDeviceTls and pass the same adbkey PEM as tls_priv_pem:

from adb_shell_wifi.adb_device import AdbDeviceTls
from adb_shell_wifi.mdns import discover_connect_services

# Find the random port the device chose for its TLS data socket.
services = discover_connect_services(timeout_s=4.0)
svc = services[0]   # or pick the right device by name/host

device = AdbDeviceTls(svc.host, svc.port, default_transport_timeout_s=10.0)
device.connect(rsa_keys=[], tls_priv_pem=priv, auth_timeout_s=10.0)
print(device.shell("echo hello from adb_shell_wifi"))
device.close()

The mdns module also exposes discover_pairing_services() for finding devices that currently have a pairing dialog open, plus async equivalents (discover_connect_services_async, discover_pairing_services_async).

Generate ADB Key Files

If you need to generate a key, you can do so as follows.

from adb_shell_wifi.auth.keygen import keygen

keygen('path/to/adbkey')