List all currently visible Android devices (USB and already-connected WiFi).

Capture the current screen of the given device as an image.

Get active and physical screen dimensions without transferring a screenshot.

Tap the screen at pixel coordinates (x, y).

Double-tap the screen at pixel coordinates (x, y).

Swipe from (x1, y1) to (x2, y2) over duration seconds.

Press a named key (home, back, recent, volume_up, ...) or raw Android keycode.

Type text into the focused field.

``auto`` only uses an unattended-safe ADBKeyBoard backend and fails clearly
when it isn't installed. ``raw`` is explicit best-effort ASCII and can be
intercepted or changed by the active Android IME.

Clear text in the currently focused input field.

Inspect the active IME and whether reliable Unicode input is available.

Launch an app and, by default, wait until it is confirmed foreground.

Wait until the requested Android package becomes the foreground app.

List installed package names on the device.

Get all UI elements on screen (text/resource-id/class/bounds/clickable) via the accessibility tree.

Return compact visible labels and bounds; prefer this over dump_ui for routine inspection.

Find the first UI element matching the given (non-None) attributes. Returns None if not found.

Wait until an accessibility element appears, then return it.

Find a UI element by attribute(s) and tap its center. Raises if no match is found.

Run OCR on the current screen for UIs with no usable accessibility tree (canvas/games/WebView). Returns matched text + bounding box + confidence.

Find text on screen via OCR (best fuzzy match) and tap its center. Raises if no good match is found.

Search installed package names containing keyword.

Get the package name of the currently foregrounded app.

Switch a USB-connected, already-trusted device into WiFi mode and connect to it. Requires the device to have been used over USB at least once already.

Connect to a WiFi device by ip:port (already tcpip-enabled or paired).

Pair with an Android 11+ wireless-debugging device using its six-digit code.

Attempt to reconnect every remembered WiFi ADB device.

List WiFi device_ids previously paired/connected, whether or not currently reachable.