pymobiledevice3는 iOS 기기(iPhone, iPad 등)와 상호작용하기 위한 순수 Python 3 구현체입니다. 명령줄 도구와 Python API를 모두 제공하며, Windows, Linux, macOS에서 실행됩니다.

주요 기능: 장치 탐색, 포트 포워딩, syslog/oslog 스트리밍, 앱 및 프로필 관리, AFC 파일 접근, 크래시 리포트, PCAP 스니핑, 펌웨어 업데이트, 복구/DFU, 백업/복원, WebInspector 자동화, 즉 CDP 브리지 Chrome DevTools, VS Code, Playwright가 기기에서 Safari와 WebView, 그리고 DDI/DVT를 디버깅할 수 있게 해줍니다 개발자 툴링(iOS 17+, 터널을 통한 것).

설치

PyPI가 유일한 공식 배포 채널입니다. 서드파티 패키지(예: AUR의 python-pymobiledevice3) 이 프로젝트에서 유지보수하지 않으며 오래되었을 수 있습니다.

그 다음 연결성을 확인하세요:

문서

📖 **전체 문서: **

• 설치 및 플랫폼 노트
• CLI 레시피
• iOS 17+ 터널 및 지원 매트릭스
• 파이썬 API 가이드
• 파이썬 API 참고 자료
• 프로토콜 내부 요소 (RemoteXPC, DTX, iDevice 계층)

문서들은 docs/에서 MkDocs(mkdocs.yml)로 빌드되었습니다.

클로드 코드 플러그인

저장소는 장치-운영자 에이전트 기술

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