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

9.15.2

9.15.1

9.15.0

9.14.2

9.14.1

This version

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.14.0.tar.gz (773.8 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.14.0-py3-none-any.whl (805.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pymobiledevice3-9.14.0.tar.gz
Algorithm Hash digest
SHA256 379d9515144a7f3b3edf6c3e61ae6e9ecbdea2f142e9a7ac679845a305482d8b
MD5 2f70e52259201e56c9108bc0d89889d0
BLAKE2b-256 e5e64713ee7df9398edce3b276fc9d8c110d7b0c3b1de511ed321333721814ae

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for pymobiledevice3-9.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 266b2755e535417c27f6b59af86a2c0f992247d0e33397c62a5a9367840b567c
MD5 fb0a032925a04714854512395818d9d0
BLAKE2b-256 132594ecc44dc729d332c5224f8f36a093702da6299b2a4f1a058f13e9961cde

See more details on using hashes here.

Provenance

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