# openatx/adbutils

pure python adb library for google adb service.

Repository: https://github.com/openatx/adbutils
Canonical: https://ross.abutalabs.com/products/adbutils
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-10T02:12:07+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 56, longevity 100
- inputs: {"age_days": 2724, "days_push": 24, "days_rel": 294, "gap_med": 7, "n_releases_24m": 20}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1071, forks 226 (observed 2026-08-28T04:03:28.304256+00:00)

## What it is
A pure Python library for communicating with the Google ADB (Android Debug Bridge) service, providing device listing, shell command execution, file transfer, and port forwarding without needing the adb binary. It also offers a command-line interface for common ADB operations.

## Use cases
- control android devices from python
- run shell commands on adb devices programmatically
- push and pull files to android device
- adb forward and reverse port forwarding in python
- list connected adb devices and their states
- connect to remote adb devices over network
- capture color logcat output
- automate android device testing

## When to choose
- you need adb functionality inside a Python application without shelling out to the adb binary
- you're building Android automation or device-farm tooling in Python
- you want fine-grained control over the adb server protocol

## When to avoid
- you need a general-purpose Android automation framework with UI interaction (use uiautomator2 or Appium instead)
- your project is not Python-based
- you only need occasional manual adb usage - the standard adb CLI is simpler

## Facets
- artifact type: library
- maturity: active
- function: developer-tools, cli, workflow-automation
- domain: developer-tools, mobile-development, android-tools
- platform: python, cli, cross-platform
- tags: adb, android, device-control, adb-server-client, shell-commands, file-transfer, port-forwarding, logcat, pure-python, automation

## Member repositories
- openatx/adbutils (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:28.304256+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-30T06:53:51.855639+00:00, confidence not recorded.
  - readme: https://github.com/openatx/adbutils (fetched 2026-08-28T04:03:28.304256+00:00, sha f8c76135dd06)
  - registry_pypi: https://pypi.org/pypi/adbutils/json (fetched 2026-08-29T12:56:16.770312+00:00, sha c1c12776e2fd)
- Data as of 2026-08-30T08:39:29.467469+00:00.