Take a screenshot of the Android device/emulator and return it as a base64 image

Get the UI element tree of the device (like DOM but for Android). Returns clickable elements with their coordinates.

Tap at the specified coordinates on the screen

Find an element by its text content and tap on it

Type text into the currently focused input field. Unicode is supported via URL-encoding. Shell metacharacters (; & | ` $ ( ) < > \ quotes) are rejected.

Perform a swipe gesture on the screen

Scroll the screen in a direction

Press a system key (BACK, HOME, ENTER, etc)

Launch an application by its package name (e.g., com.android.chrome). Package name is validated against the Android package naming convention.

Install an APK file on the device. Path must end in .apk and contain no shell metacharacters.

List installed packages on the device. Optional filter is applied in-process (JavaScript), never on the device shell.

Get device logs (logcat). Filtering is applied in-process, never on the device shell.

Get information about the connected device

Clear all data for an application

Force stop an application

Get the currently focused activity/screen

Wait for a UI element with specific text to appear

Perform a long press at the specified coordinates (useful for context menus)

Clear the currently focused text input field

Select all text in the currently focused input field

Clear the current input field and type new text. Unicode is supported via URL-encoding. Shell metacharacters are rejected.

Perform a drag gesture from one point to another (slower than swipe, for drag & drop)

Perform a double tap at the specified coordinates

Get the screen dimensions and density of the device

Check if an element with specific text or resource-id is visible on screen

Get the exact bounds and center coordinates of an element

Scroll the screen until an element with specific text is visible

Wait for the UI to stop changing (useful after animations)

Wait for an element to disappear from the screen

Perform multiple rapid taps at the same position

Perform a pinch zoom gesture (requires Android 8+)

Set text to the device clipboard. Text is transferred via adb push (binary transfer, no shell involvement, full Unicode support).

Get the current device clipboard content

Rotate the device to portrait or landscape orientation

Tap at coordinates while avoiding system navigation bars

Find and tap an element by text or resource-id (more reliable than tap_text)

Get information about the currently focused UI element

Assert that specific text is visible on screen (useful for testing)

Get all visible text elements on screen (useful for debugging and verification)

Get all clickable elements on screen with their text, resource-id, and coordinates (useful when tap_text fails)

Check if the soft keyboard is currently visible on screen

Get the current text value of the focused input field