Adb Android Control

adb-android-control

Control an Android phone from your computer — or from another phone — over USB or Wi-Fi, with a clean Python API and CLI.

[](https://www.python.org/) [](LICENSE) [](tests/) [](pyproject.toml)

**Find this project:** `#adb` · `#android` · `#wireless-debugging` · `#termux` · `#automation` · `#python` · `#foldable` · `#zfold` · `#fold7` · `#samsung` · `#claude-code` · `#folding-phone` · `#phone-automation`

**Languages:** [English](#what-it-does) · [Български](#какво-представлява)

---

What it does

`adb-android-control` wraps the standard Android `adb` tool in a simple, typed Python package and CLI. Works on:

• Linux, macOS — your desktop
• Termux (Android) — run it on the phone itself, no PC needed (works great on folding phones like the Galaxy Z Fold)

Pairs with **Claude Code** as a skill, but works fine on its own.

Codebase at a glance

10 modules · 213 functions · 3,030 lines · every function ≤ 30 LOC · 312 tests


Contents

• Install
• Quick start
  • 1. Connect a device
  • 2. Use the CLI
  • 3. Use the Python API
  • 4. Run a workflow
• Commands
• Auto-reconnect (Termux)
• Troubleshooting
• Why this exists
• Development

---

Install

pip install adb-android-control        # once published to PyPI
# or from this repo:
pip install -e .

As a Claude Code skill:

git clone https://github.com/hah23255/adb-android-control.git \
    ~/.claude/skills/adb-android-control
claude /plugin marke