Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

doronz88/pymobiledevice3

Developer Tools

Pure Python CLI and API for controlling iPhones and iPads like adb, including logs, files, backups and debugging.

3,054
436
Python
GPL-3.0
5 years old

Overview

pymobiledevice3 is a pure Python 3 implementation of the protocols used to talk to iOS devices, and it works on Windows, Linux and macOS. It provides both a command-line tool and a Python API, roughly the iOS equivalent of Android's adb (1).

The tool covers common device operations: listing connected devices, querying installed apps, streaming syslog, reading crash reports, browsing device files and making backups. It also exposes developer services without Xcode, such as screenshots, location simulation and DDI mounting, with iOS 17+ commands establishing a no-root tunnel automatically. More advanced features include browser or VNC screen mirroring with input control, per-process packet capture feeding Wireshark, live strace-style syscall tracing, and a JavaScript shell/CDP bridge for Safari and WebViews (16) (17) (18) (19).

It suits iOS developers, QA engineers and security researchers who need scriptable device access outside Xcode, or who want to integrate device operations into their own Python tooling.

Install and first commands

On Windows and Linux, install the platform prerequisites first: iTunes on Windows, or usbmuxd on Linux (24). Then install the CLI with uv, which can fetch a compatible Python itself:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# in a new terminal
uv tool install --managed-python pymobiledevice3

Connect the device by USB, unlock it, and check connectivity:

pymobiledevice3 usbmux list   # list connected devices
pymobiledevice3 apps list     # first device command; tap "Trust" on the device if prompted
pymobiledevice3 syslog live   # stream the device log; Ctrl+C to stop

To use the API instead, install the package into a project virtualenv with pip install pymobiledevice3 (23). Upgrade the CLI with uv tool upgrade pymobiledevice3, or run it without installing via uvx --managed-python pymobiledevice3 usbmux list.

Constraints

PyPI is the only official distribution channel; third-party packages such as the AUR build are not maintained by the project and may lag behind. Windows and Linux need iTunes or usbmuxd before any device command works, and the device must be unlocked and trusted. iOS 17+ developer services depend on the tunnel handling built into the commands. The project is licensed under GPL-3.0, and shipping it inside a closed-source application needs to be checked against the project's FAQ first (46). Detailed platform notes, CLI recipes and the tunnel support matrix are in the documentation.

HotRepo's take

The repository has over 3,000 stars and is built around a broad protocol implementation rather than a thin wrapper, with documentation covering installation, CLI recipes, the Python API and protocol internals. Its design choices line up with that scope: Python-only, running on all three desktop platforms, and covering both interactive device work and scripted automation. There is no HotRepo ranking or growth history recorded for this project, so the observation here rests on the repository's stated capabilities, documentation and license rather than on trending data.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. google-gemini/gemini-api-cliA Go CLI that lets coding agents and shell scripts call Gemini models, generate media, analyze files, and run managed agents.Go462
  2. rorkai/App-Store-Connect-CLIA scriptable command-line client for the App Store Connect API, aimed at teams that automate iOS release chores.Go8,061
  3. cli/cliAn official command line tool for working with GitHub pull requests, issues, and repositories from the terminal.Go46,901
  4. mvanhorn/cli-printing-pressTurns an API, spec, HAR, or site into a typed Go CLI plus MCP server designed for agents to call repeatedly.Go4,859
  5. googlecolab/google-colab-cliRun and manage Google Colab CPU, GPU, and TPU runtimes from the terminal.Python2,055