---
id: uiautomator
version: "1.0.2"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# uiautomator — Python Wrapper for Android UiAutomator test tool

License: permissive · Maintenance: abandoned · Downloads: 84.4K/mo

## What it is and what it does

uiautomator is a Python wrapper around Android's native uiautomator testing framework, allowing you to write test automation and UI interaction scripts in Python that run against Android devices connected via ADB. It provides a high-level API for clicking UI elements, swiping, dragging, checking screen state, pressing keys, and registering watchers to handle dynamic UI conditions—all without needing to install anything on the Android device itself.

The package works by communicating with the Android device through ADB commands. You import a device object, then interact with it using selectors to find UI elements by text, resource ID, or other properties, and perform actions like clicks, long-clicks, and gestures. It supports retrieving device info, taking screenshots, dumping the view hierarchy, and managing screen orientation. However, the package has been abandoned since 2020 and receives no maintenance, so compatibility with modern Android versions and Python releases is uncertain.

Use it for:

- Automated testing of Android app UI flows and user interactions in CI/CD pipelines
- Regression testing by scripting repetitive UI actions across multiple Android devices
- Device automation tasks like taking screenshots, checking screen state, or pressing keys programmatically
- Functional testing of Android applications without modifying the app's source code

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python wrapper for Android's uiautomator testing framework that automates UI interactions on Android devices via ADB without requiring installation on the device itself.

No. While the package is permissively licensed and has no known vulnerabilities, it is abandoned (last update 2020) and carries high install friction due to external Android SDK and ADB dependencies. For active Android test automation, consider maintained alternatives. If you must use it, verify compatibility with your target Android versions and Python release first.

## Install

pip install uiautomator
uv add uiautomator
poetry add uiautomator

## Installing uiautomator

Before you install: High install friction: requires Android SDK, ANDROID_HOME environment variable, ADB setup, and a connected Android device. Package is abandoned with no updates since 2020.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it safe from a licensing standpoint for most projects.

Quickstart:

pip install uiautomator

from uiautomator import device as d

d.screen.on()
d(text="Clock").click()

Requires Android SDK installed with ANDROID_HOME environment variable set, ADB enabled on device, USB connection to Android device, and Android 4.1+ (API Level 16–30).

Verify before relying:

- Whether the package works reliably with Android API levels beyond 30 or modern Python 3.x releases
- Current compatibility with contemporary ADB implementations and Android SDK versions
- Whether the codebase has known issues or breaking changes affecting typical use cases

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 84.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

android ui automation testing, android uiautomator python wrapper, adb device automation, android app testing framework, ui element interaction android, android device control python, android-testing, ui-automation, abandoned

[View on SkillFed](https://skillfed.io/packages/uiautomator) · [View on PyPI](https://pypi.org/project/uiautomator/)