pymobiledevice3 是一个纯 Python 3 实现，用于与 iOS 设备（iPhone、iPad 等）交互。 它同时自带了命令行工具和Python API，并能运行在Windows、Linux和macOS上。

重点：设备发现、端口转发、syslog/oslog流式传输、应用和配置文件管理、AFC 文件访问、崩溃报告、PCAP嗅探、固件更新、恢复/DFU、备份/恢复、WebInspector 自动化，一个CDP桥接器 让 Chrome DevTools、VS Code 和 Playwright 在设备上调试 Safari 和 WebViews，以及 DDI/DVT 开发者工具（iOS 17+，通过隧道）。

安装

PyPI 是唯一的官方分发渠道。第三方软件包（例如 AUR 的 python-pymobiledevice3）不由本项目维护，且可能已过时。

然后验证连接性：

文献资料

📖 完整文档：

• 安装与平台说明
• CLI 配方
• iOS 17+ 隧道及支持矩阵
• Python API 指南
• Python API 参考
• 协议内部结构（RemoteXPC、DTX、iDevice层）

文档是基于 docs/ 和 MkDocs（mkdocs.yml）构建的。

Claude Code 插件

该仓库运送其 设备操作员技能

PyMobileDevice3

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, a CDP bridge that lets Chrome DevTools, VS Code and Playwright debug Safari and WebViews on the device, and DDI/DVT developer tooling (iOS 17+ over a tunnel).

Install

python3 -m pip install -U pymobiledevice3

PyPI is the only official distribution channel. Third-party packages (for example the AUR’s python-pymobiledevice3) are not maintained by this project and may be outdated.

Then verify connectivity:

pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list

Documentation

📖 **Full documentation: **

• Installation & platform notes
• CLI recipes
• iOS 17+ tunnels & support matrix
• Python API guide
• Python API reference
• Protocol internals (RemoteXPC, DTX, iDevice layers)

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