Metadata-Version: 2.4
Name: pymobiledevice3
Version: 9.32.0
Summary: Pure python3 implementation for working with iDevices (iPhone, etc...)
Author-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>
Maintainer-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/doronz88/pymobiledevice3
Project-URL: Bug Reports, https://github.com/doronz88/pymobiledevice3/issues
Keywords: ios,protocol,lockdownd,instruments,automation,cli,afc
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: construct>=2.9.29
Requires-Dist: construct-typing>=0.7.0
Requires-Dist: asn1
Requires-Dist: coloredlogs
Requires-Dist: IPython
Requires-Dist: bpylist2>=4.0.1
Requires-Dist: pygments
Requires-Dist: hexdump
Requires-Dist: daemonize
Requires-Dist: gpxpy!=1.6.0,<1.7.0
Requires-Dist: pykdebugparser>=1.2.7
Requires-Dist: pyusb>=1.2.1
Requires-Dist: tqdm
Requires-Dist: requests
Requires-Dist: xonsh
Requires-Dist: parameter_decorators
Requires-Dist: packaging
Requires-Dist: pygnuutils>=0.0.7
Requires-Dist: cryptography>=41.0.1
Requires-Dist: pycrashreport>=2.0.0
Requires-Dist: fastapi>=0.93.0
Requires-Dist: uvicorn>=0.15.0
Requires-Dist: wsproto
Requires-Dist: Pillow
Requires-Dist: inquirer3>=0.6.0
Requires-Dist: ipsw_parser>=1.6.0
Requires-Dist: ifaddr
Requires-Dist: hyperframe
Requires-Dist: srptools
Requires-Dist: qh3<2,>=1.0.0
Requires-Dist: developer_disk_image>=0.0.2
Requires-Dist: opack2
Requires-Dist: psutil
Requires-Dist: pytun-pmd3>=3.0.3
Requires-Dist: prompt_toolkit
Requires-Dist: sslpsk-pmd3>=1.0.3; python_version < "3.13"
Requires-Dist: python-pcapng>=2.1.1
Requires-Dist: plumbum
Requires-Dist: pyimg4>=0.8.8
Requires-Dist: pyiosbackup>=0.2.4
Requires-Dist: typer<0.24.0,>=0.23.2; python_version < "3.10"
Requires-Dist: typer>=0.25; python_version >= "3.10"
Requires-Dist: typer-injector>=0.2.0
Requires-Dist: defusedxml
Requires-Dist: pywin32; platform_system == "Windows"
Requires-Dist: av>=14.0.0; platform_system != "Darwin"
Requires-Dist: pmd-pytcp>=0.0.4; python_version >= "3.9"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5; python_version >= "3.10" and extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.26; python_version >= "3.10" and extra == "docs"
Requires-Dist: mkdocs-llmstxt>=0.5; python_version >= "3.10" and extra == "docs"
Provides-Extra: full
Requires-Dist: pymobiledevice3[docs,test]; extra == "full"
Dynamic: license-file

# PyMobileDevice3

<!-- markdownlint-disable MD013 -->
[![Python application](https://github.com/doronz88/pymobiledevice3/workflows/Python%20application/badge.svg)](https://github.com/doronz88/pymobiledevice3/actions/workflows/python-app.yml "Python application action")
[![Pypi version](https://img.shields.io/pypi/v/pymobiledevice3.svg)](https://pypi.org/project/pymobiledevice3/ "PyPi package")
[![Downloads](https://static.pepy.tech/personalized-badge/pymobiledevice3?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/pymobiledevice3)
[![Discord](https://img.shields.io/discord/1133265168051208214?logo=Discord&label=Discord)](https://discord.gg/52mZGC3JXJ)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/doronz88/pymobiledevice3)
<!-- markdownlint-enable MD013 -->

`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

```shell
python3 -m pip install -U pymobiledevice3
```

Then verify connectivity:

```shell
pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list
```

## Documentation

📖 **Full documentation: <https://doronz88.github.io/pymobiledevice3/>**

- [Installation & platform notes](https://doronz88.github.io/pymobiledevice3/installation/)
- [CLI recipes](https://doronz88.github.io/pymobiledevice3/guides/cli-recipes/)
- [iOS 17+ tunnels & support matrix](https://doronz88.github.io/pymobiledevice3/guides/ios17-tunnels/)
- [Python API guide](https://doronz88.github.io/pymobiledevice3/guides/python-api/)
- [Python API reference](https://doronz88.github.io/pymobiledevice3/api/)
- [Protocol internals (RemoteXPC, DTX, iDevice layers)](https://doronz88.github.io/pymobiledevice3/internals/idevice-protocol-layers/)

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

## Community

Questions, ideas, or want to help? Join the community on [Discord](https://discord.gg/52mZGC3JXJ).

## Contributing

See [CONTRIBUTING](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
Agent-specific contributor guidance is in [AGENTS](AGENTS.md).

## License and Credits

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

- Hector Martin "marcan" <hector@marcansoft.com>
- Mathieu Renard
- [doronz](https://github.com/doronz88) <doron88@gmail.com>
- [matan1008](https://github.com/matan1008) <matan1008@gmail.com>
- [Guy Salton](https://github.com/guysalt)
- [netanelc305](https://github.com/netanelc305) <netanelc305@protonmail.com>
- Inbar Agmon <inbar2812@gmail.com> ([Project's logo](https://repository-images.githubusercontent.com/357904774/6d6fb035-5953-425d-9afd-cc1087df0cfb))
