PyMobileDevice3

August 19, 2026 · View on GitHub

Python application Pypi version Downloads Discord Ask DeepWiki

pymobiledevice3 is a pure Python 3 implementation for interacting with iOS devices (iPhone, iPad, ...). It ships both a command-line tool and a Python API, and runs on Windows, Linux, and macOS.

Highlights: device discovery, port forwarding, syslog/oslog streaming, app & profile management, AFC file access, crash reports, PCAP sniffing, firmware update, recovery/DFU, backup/restore, WebInspector automation, and DDI/DVT developer tooling (iOS 17+ over a tunnel).

Install

python3 -m pip install -U pymobiledevice3

Then verify connectivity:

pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list

Documentation

📖 Full documentation: https://doronz88.github.io/pymobiledevice3/

The docs are built from docs/ with MkDocs (mkdocs.yml).

Claude Code plugin

The repository ships its device-operator agent skill as a Claude Code plugin, teaching the agent to operate a connected iPhone or iPad through pymobiledevice3:

/plugin marketplace add doronz88/pymobiledevice3
/plugin install pymobiledevice3-device-operator@pymobiledevice3

Community

Questions, ideas, or want to help? Join the community on Discord.

Sponsors

A huge thank you to our sponsors for supporting this project! 💖

TestMu AI (formerly LambdaTest)

SmartDust SmartDust

AnNEDoMini AnNEDoMini

Want to support the project as well? Sponsor it via GitHub Sponsors or Ko-fi.

Contributing

See CONTRIBUTING and Code of Conduct. Agent-specific contributor guidance is in AGENTS.

License and Credits

This work is licensed under GPL 3.0 and credited to several major contributors: