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.9.1

This version

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.9.0.tar.gz (758.3 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.9.0-py3-none-any.whl (797.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pymobiledevice3-9.9.0.tar.gz
Algorithm Hash digest
SHA256 0ceb28a1c5dad6a8112e698fe295d6a7cf3748afd9ce5f237997832853f4affb
MD5 d6ccf8e2c5a960283548a388df334032
BLAKE2b-256 c0d024e33508a3a034555745592152af186a1d19d9325743feeca376ffac08cf

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymobiledevice3-9.9.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.9.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pymobiledevice3-9.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f6140b673af0b31e155b27239a34f744289977656c28a97ce64583c840f5197d
MD5 586da3f7a51778cdf54fff38faefb34b
BLAKE2b-256 7a59e154c1bb422c11194c8bf17f4f7e2c2e6914f9e9ccb7df48dd346d54de44

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymobiledevice3-9.9.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