Start a scrcpy session for fast input control and screenshots. When a session is active, tap/swipe/text/screenshot are 10-50x faster. Requires scrcpy-server to be installed.

Stop the active scrcpy session. Tools will fall back to ADB commands.

List all connected Android devices with their serial numbers, state, and model

Get detailed info about a device: model, Android version, screen size, SDK level, battery level

Wake the device screen (turn screen on)

Turn the device screen off

Enable WiFi ADB and connect to the device wirelessly. Returns the connection address.

Disconnect from a wireless ADB device

Rotate the device screen (requires active scrcpy session)

Expand the notification panel (requires active scrcpy session)

Expand the quick settings panel (requires active scrcpy session)

Collapse all open panels (notification, settings) (requires active scrcpy session)

Take a screenshot of the Android device screen. Returns the image as base64.

Start recording the screen. Recording continues until screen_record_stop is called.

Stop screen recording and optionally pull the file to the host.

Tap at the specified screen coordinates

Perform a swipe gesture from one point to another

Perform a long press at the specified coordinates

Perform a drag and drop gesture from one point to another. Uses input draganddrop on Android 8.0+ (API 26), falls back to swipe on older versions.

Type text into the currently focused input field

Send a key event to the device. Supports keycodes like HOME, BACK, ENTER, VOLUME_UP, etc.

Scroll at the specified position. dx and dy are scroll amounts (-1 to 1 range approximated for ADB).

Launch an app on the device. Uses scrcpy START_APP when a session is active for faster launch, falls back to ADB am start. Supports force-stop prefix (+) to stop the app before launching.

Force-stop an app on the device.

Install an APK file on the device from the host machine.

Uninstall an app from the device.

List installed packages on the device. Optionally filter by name or restrict to system/third-party apps.

Get the currently foregrounded app package name and activity.

Get the current clipboard content from the device. Uses scrcpy GET_CLIPBOARD when a session is active (works on Android 10+), falls back to ADB clipboard commands.

Set the clipboard content on the device. Uses scrcpy SET_CLIPBOARD when a session is active (with optional paste flag), falls back to ADB clipboard commands.

Dump the full UI hierarchy of the current screen as XML. Useful for understanding screen structure before using ui_find_element.

Find UI elements on screen by text, resource ID, class name, or content description. Returns matching elements with their tap coordinates. At least one search criterion must be provided.

Execute an arbitrary ADB shell command on the device and return the output. Use this for any device operation not covered by other tools.

Push a file from the host machine to the device.

Pull a file from the device to the host machine.

List directory contents on the device.

Start an HTTP MJPEG video stream of the device screen. Opens a native ffplay window that connects to the stream URL. Requires an active scrcpy session.

Stop the HTTP MJPEG video stream and close the viewer window for a device.