# xiaocong/uiautomator

Python wrapper of Android uiautomator test tool.

Repository: https://github.com/xiaocong/uiautomator
Canonical: https://ross.abutalabs.com/products/uiautomator
Language: Python
License: MIT
License Family: permissive
Last push: 2023-02-28T00:25:02+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4763, "days_push": 1283, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2095, forks 631 (observed 2026-08-28T04:06:13.206928+00:00)

## What it is
A Python wrapper around Android's uiautomator testing framework that lets you control and inspect Android devices over adb from Python code. It supports clicking UI elements, gestures, key events, watchers, and selectors without installing anything on the device.

## Use cases
- automate android ui tests from python
- click buttons on an android device via adb
- write python scripts to control an android phone
- run ui automation on android without installing an apk
- inspect and interact with android ui elements programmatically

## When to choose
- you need Python-based Android UI automation on Android 4.1+ (API 16-30)
- you want device control over adb with no on-device installation
- you need selectors, watchers, and gesture APIs for Android testing

## When to avoid
- you target Android 11+ or newer APIs beyond level 30
- you prefer modern maintained alternatives like uiautomator2 or Appium
- you need iOS or cross-platform mobile testing

## Facets
- artifact type: library
- maturity: maintenance
- function: testing, e2e-testing, workflow-automation
- domain: mobile-development, testing
- platform: python, cli
- tags: android, uiautomator, adb, ui-automation, device-testing, automation

## Member repositories
- xiaocong/uiautomator (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:13.206928+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:55:24.649552+00:00, confidence not recorded.
  - readme: https://github.com/xiaocong/uiautomator (fetched 2026-08-28T04:06:13.206928+00:00, sha ed729b515cd1)
  - registry_pypi: https://pypi.org/pypi/uiautomator/json (fetched 2026-08-29T10:35:02.029511+00:00, sha 4e5130eef97a)
- Data as of 2026-08-30T08:39:29.467469+00:00.