List the Android devices adb currently knows about.

Scan the local network for devices with the adb port open. Use when a device's IP changed (DHCP) or nothing is connected.

Connect to a device over the network by ip[:port] or alias.

Begin pairing an Android 11+ phone or tablet by QR code. Returns a QR image to show the person; they point the device's camera at it from Wireless debugging > 'Pair device with QR code'. Then call adb_pair_qr_finish. Use this when a device has never been paired with this machine; an already-paired device just needs adb_connect.

Wait for the device to scan the code from adb_pair_qr_start, pair with it, and connect. Blocks until it happens or the timeout runs out.

Press remote-control keys, in order. Names: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, apps, back, blue, captions, channeldown, channelup, delete, down, enter, forward, green, guide, home, info, input, left, menu, mute, next, notifications, ok, pause, play, playpause, power, prev, record, red, rewind, right, search, settings, sleep, space, stop, tab, tv, up, voldown, volup, wake, yellow

Type text into the field that currently has focus.

Tap a point on the screen. For phones and tablets - a TV is driven with adb_key instead. Take a screenshot first to find the coordinates, and adb_screen_size to know the bounds.

Swipe from one point to another. The same point twice, with a longer duration_ms, is a long press.

Scroll the screen up, down, left or right without working out coordinates.

The screen size in pixels, so taps and swipes can be aimed.

List installed packages (third-party by default).

Launch an app by friendly alias (netflix, youtube, spotify...), full package name, or a fragment of one.

Force-stop an app.

Open a URL or deep link, optionally in a specific app.

Search YouTube on the device without using the on-screen keyboard.

Set an alarm in the device's clock app. Phones and tablets only - most TVs have no clock app and the call will say so.

Start a countdown timer in the device's clock app.

What is in the foreground, whether the screen is on, and whether media is playing. Call this to check an action worked.

Capture the screen and return it as an image you can look at. Large screens are scaled down on the way (ffmpeg, when it is installed) so you get the picture sooner; pass max_size to change that, or 0 for the untouched original.

Change the volume: up, down, mute, or set an exact level.

Put the screen to sleep or wake the device.

Open a live window of the device's screen on the operator's computer, using scrcpy, so a human can watch what you are doing and take over with mouse and keyboard. It is for them, not for you: you cannot see the window, so keep using adb_screenshot to look at the screen. Needs scrcpy installed and a desktop session; it does not work from Termux.

Run any adb shell command on the device and return its output - dumpsys, pm, am, settings, getprop, input, wm, content, and so on. Use it for what the other tools do not cover; prefer them when they do. Runs as the shell user (no root). Can be switched off with ADBAI_NO_SHELL=1.