Pure python3 implementation for working with iDevices (iPhone, etc...)

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for doronz from gravatar.com doronz

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: GPL-3.0-or-later
    SPDX License Expression
  • Author: doronz88
  • Maintainer: doronz88
  • Tags ios , protocol , lockdownd , instruments , automation , cli , afc
  • Requires: Python >=3.9
  • Provides-Extra: test , full
Classifiers
Report project as malware

Project description

PyMobileDevice3

Python application Pypi version Downloads Discord Ask DeepWiki

Overview

pymobiledevice3 is a pure Python 3 implementation for interacting with iOS devices (iPhone, iPad, ...). It includes both a CLI and a Python API and is supported on:

  • Windows
  • Linux
  • macOS

Main features:

  • Device discovery over bonjour
  • TCP port forwarding
  • Syslog and oslog streaming
  • Profile and application management
  • AFC file access
  • Crash report collection
  • Network sniffing (PCAP)
  • Firmware update
  • Recovery/DFU workflows
  • Notification listen/post (notify_post())
  • Querying and setting SpringBoard options
  • WebInspector automation
  • DDI/DVT developer tooling
  • Backup and restore

Quick Start

Install from PyPI:

python3 -m pip install -U pymobiledevice3

Or install from source:

git clone git@github.com:doronz88/pymobiledevice3.git
cd pymobiledevice3
python3 -m pip install -U -e .

Verify connectivity and run first commands:

pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list

Platform Notes

Support Matrix (Developer Services)

iOS >= 17 developer services require tunnel-based transport.

Host OS iOS 17.0-17.3.1 iOS 17.4+
macOS Supported Supported
Windows Supported (requires additional drivers) Supported
Linux Limited Supported (lockdown tunnel)

See the detailed guide: iOS 17+ tunnels

Common CLI Tasks

See full recipes: CLI recipes

# List connected devices
pymobiledevice3 usbmux list

# Watch syslog
pymobiledevice3 syslog live

# Pull crash reports
pymobiledevice3 crash pull /path/to/crashes

# Mount DDI
pymobiledevice3 mounter auto-mount

# DVT screenshot (requires developer setup)
pymobiledevice3 developer dvt screenshot /path/to/screen.png

Install shell completions:

pymobiledevice3 install-completions

Python API and Protocol Internals

Documentation Map

See Documentation index for task-focused guides.

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:

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for doronz from gravatar.com doronz

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: GPL-3.0-or-later
    SPDX License Expression
  • Author: doronz88
  • Maintainer: doronz88
  • Tags ios , protocol , lockdownd , instruments , automation , cli , afc
  • Requires: Python >=3.9
  • Provides-Extra: test , full
Classifiers

Release history Release notifications | RSS feed

9.27.0

9.26.0

This version

9.25.0

9.24.0

9.23.0

9.22.0

9.21.1

9.21.0

9.20.0

9.19.0

9.18.0

9.17.0

9.16.0

9.15.2

9.15.1

9.15.0

9.14.2

9.14.1

9.14.0

9.13.2

9.13.1

9.13.0

9.12.3

9.12.2

9.12.1

9.12.0

9.11.1

9.11.0

9.10.1

9.10.0

9.9.1

9.9.0

9.8.3

9.8.2

9.8.1

9.8.0

9.7.3

9.7.2

9.7.1

9.7.0

9.6.1

9.6.0

9.5.1

9.4.6

9.4.5

9.4.4

9.4.3

9.3.0

9.2.0

9.1.4

9.1.3

9.1.2

9.1.1

9.0.0

8.2.4

8.2.3

8.2.2

8.2.1

8.2.0

8.1.2

8.1.1

8.1.0

8.0.0

7.8.3

7.8.2

7.8.1

7.8.0

7.7.4

7.7.3

7.7.2

7.7.1

7.7.0

7.6.0

7.5.1

7.5.0

7.4.1

7.4.0

7.3.9

7.3.8

7.3.7

7.3.6

7.3.5

7.3.4

7.3.2

7.3.1

7.3.0

7.2.1

7.2.0

7.1.0

7.0.7

7.0.6

7.0.5

7.0.4

7.0.3

7.0.2

7.0.1

7.0.0

6.2.0

6.1.6

6.1.5

6.1.4

6.1.2

6.1.1

6.1.0

6.0.1

6.0.0

5.3.2

5.3.1

5.3.0

5.2.0

5.1.4

5.1.3

5.1.2

5.1.1

5.0.4

5.0.3

5.0.2

5.0.1

5.0.0

4.27.7

4.27.6

4.27.5

4.27.4

4.27.3

4.27.2

4.27.1

4.27.0

4.26.7

4.26.6

4.26.5

4.26.4

4.26.3

4.26.2

4.26.1

4.26.0

4.25.1

4.25.0

4.24.3

4.24.2

4.24.1

4.24.0

4.23.0

4.22.1

4.22.0

4.21.10

4.21.9

4.21.8

4.21.6

4.21.5

4.21.4

4.21.3

4.21.2

4.21.1

4.21.0

4.20.31

4.20.30

4.20.29

4.20.28

4.20.27

4.20.26

4.20.25

4.20.24

4.20.23

4.20.22

4.20.21

4.20.20

4.20.19

4.20.18

4.20.17

4.20.16

4.20.15

4.20.14

4.20.13

4.20.12

4.20.11

4.20.10

4.20.9

4.20.8

4.20.7

4.20.6

4.20.5

4.20.4

4.20.3

4.20.2

4.20.1

4.20.0

4.19.0

4.18.5

4.18.4

4.18.3

4.18.2

4.18.1

4.18.0

4.17.4

4.17.3

4.17.2

4.17.1

4.17.0

4.16.7

4.16.6

4.16.5

4.16.4

4.16.3

4.16.2

4.16.1

4.16.0

4.15.5

4.15.4

4.15.3

4.15.2

4.15.1

4.15.0

4.14.20

4.14.19

4.14.18

4.14.17

4.14.16

4.14.15

4.14.14

4.14.13

4.14.12

4.14.11

4.14.10

4.14.9

4.14.8

4.14.7

4.14.6

4.14.5

4.14.4

4.14.3

4.14.2

4.14.1

4.14.0

4.13.27

4.13.26

4.13.25

4.13.24

4.13.23

4.13.22

4.13.21

4.13.20

4.13.19

4.13.18

4.13.17

4.13.16

4.13.15

4.13.14

4.13.13

4.13.12

4.13.11

4.13.10

4.13.9

4.13.8

4.13.7

4.13.6

4.13.5

4.13.4

4.13.3

4.13.2

4.13.1

4.13.0

4.12.0

4.11.22

4.11.21

4.11.20

4.11.19

4.11.18

4.11.17

4.11.16

4.11.15

4.11.14

4.11.13

4.11.12

4.11.11

4.11.10

4.11.9

4.11.8

4.11.7

4.11.6

4.11.5

4.11.4

4.11.3

4.11.2

4.11.1

4.11.0

4.10.14

4.10.13

4.10.12

4.10.11

4.10.10

4.10.9

4.10.8

4.10.7

4.10.6

4.10.5

4.10.4

4.10.3

4.10.2

4.10.1

4.10.0

4.9.6

4.9.5

4.9.4

4.9.3

4.9.2

4.9.1

4.9.0

4.8.9

4.8.8

4.8.7

4.8.6

4.8.5

4.8.4

4.8.3

4.8.2

4.8.1

4.8.0

4.7.2

4.7.1

4.7.0

4.6.0

4.5.6

4.5.5

4.5.4

4.5.3

4.5.2

4.5.1

4.5.0

4.4.1

4.4.0

4.3.1

4.3.0

4.2.3

4.2.2

4.2.1

4.2.0

4.1.4

4.1.3

4.1.2

4.1.1

4.1.0

4.0.0

3.4.4

3.4.3

3.4.2

3.4.1

3.4.0

3.3.3

3.2.0

3.1.0

3.0.3

2.46.2

2.46.1

2.46.0

2.45.0

2.44.0

2.43.8

2.43.7

2.43.6

2.43.5

2.43.4

2.43.3

2.43.2

2.43.1

2.43.0

2.42.2

2.42.1

2.42.0

2.41.0

2.40.0

2.39.2

2.39.1

2.39.0

2.38.1

2.38.0

2.37.1

2.37.0

2.36.2

2.36.1

2.35.0

2.34.0

2.33.2

2.32.0

2.31.1

2.31.0

2.30.1

2.30.0

2.29.4

2.29.3

2.29.2

2.29.1

2.29.0

2.28.0

2.27.1

2.27.0

2.26.1

2.26.0

2.25.0

2.24.1

2.24.0

2.23.0

2.22.2

2.22.0

2.21.1

2.21.0

2.20.0

2.19.1

2.19.0

2.18.1

2.18.0

2.17.2

2.17.1

2.17.0

2.16.0

2.15.2

2.15.1

2.15.0

2.14.0

2.13.2

2.13.1

2.13.0

2.12.1

2.12.0

2.11.1

2.11.0

2.10.1

2.10.0

2.9.0

2.8.5

2.8.4

2.8.3

2.8.2

2.8.1

2.8.0

2.7.0

2.6.1

2.6.0

2.5.1

2.5.0

2.4.0

2.3.1

2.3.0

2.2.2

2.2.1

2.2.0

2.1.0

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.42.4

1.42.3

1.42.2

1.42.1

1.42.0

1.41.0

1.40.0

1.39.0

1.38.3

1.38.2

1.38.1

1.38.0

1.37.0

1.36.7

1.36.6

1.36.5

1.36.4

1.36.3

1.36.2

1.36.1

1.36.0

1.35.0

1.34.2

1.34.1

1.34.0

1.33.0

1.32.4

1.32.3

1.32.2

1.32.1

1.32.0

1.31.0

1.30.2

1.30.1

1.30.0

1.29.3

1.29.2

1.29.1

1.29.0

1.28.0

1.27.7

1.27.6

1.27.5

1.27.4

1.27.3

1.27.2

1.27.1

1.27.0

1.26.1

1.26.0

1.25.1

1.25.0

1.24.2

1.24.1

1.24.0

1.23.9

1.23.8

1.23.7

1.23.6

1.23.5

1.23.4

1.23.3

1.23.2

1.23.1

1.23.0

1.22.1

1.22.0

1.21.0

1.20.6

1.20.4

1.20.3

1.20.2

1.20.1

1.20.0

1.19.4

1.19.3

1.19.2

1.19.1

1.19.0

1.18.0

1.17.3

1.17.2

1.17.1

1.17.0

1.16.4

1.16.3

1.16.2

1.16.1

1.16.0

1.15.0

1.14.12

1.14.11

1.14.10

1.14.9

1.14.8

1.14.7

1.14.6

1.14.5

1.14.4

1.14.3

1.14.2

1.14.1

1.14.0

1.13.3

1.13.2

1.13.1

1.13.0

1.12.1

1.12.0

1.11.1

1.11.0

1.10.5

1.10.4

1.10.3

1.10.2

1.10.1

1.10.0

1.9.12

1.9.11

1.9.10

1.9.9

1.9.8

1.9.7

1.9.6

1.9.5

1.9.4

1.9.3

1.9.2

1.9.1

1.9.0

1.8.0

1.7.1

1.7.0

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.3

1.5.2

1.5.1

1.5

1.4

1.3

1.2

1.1

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymobiledevice3-9.25.0.tar.gz (895.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pymobiledevice3-9.25.0-py3-none-any.whl (930.7 kB view details)

Uploaded Python 3

File details

Details for the file pymobiledevice3-9.25.0.tar.gz.

File metadata

  • Download URL: pymobiledevice3-9.25.0.tar.gz
  • Upload date:
  • Size: 895.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pymobiledevice3-9.25.0.tar.gz
Algorithm Hash digest
SHA256 262d7dbdeb295125a7b7ebfdbf5b02c7b5f0ce9695cc3dfc1ba3241d7162e4fe
MD5 91fbedafbf0f64e3ab981fce66f2b781
BLAKE2b-256 a2ba0b505ac6312dc2ffc841f34387a9c00a481375714904fe7b6880283c2c74

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymobiledevice3-9.25.0.tar.gz:

Publisher: python-publish.yml on doronz88/pymobiledevice3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymobiledevice3-9.25.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pymobiledevice3-9.25.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c57421fd29f04631839b8dd5abef87f69cc6ae8f37d31f6008de921aa4de4689
MD5 03c6a3c644d2d3786ca2dc2922e39d68
BLAKE2b-256 ec7bad6fbb35ff3d8e23877f89e2b8ac5b8b67a792190866b636733c246c4c91

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymobiledevice3-9.25.0-py3-none-any.whl:

Publisher: python-publish.yml on doronz88/pymobiledevice3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page