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

This version

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.15.2.tar.gz (775.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.15.2-py3-none-any.whl (806.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pymobiledevice3-9.15.2.tar.gz
  • Upload date:
  • Size: 775.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.15.2.tar.gz
Algorithm Hash digest
SHA256 5475de72fc4e384c9244e79a8c47b09b9e14414455a60a0b7bc80aa9b39e3a1d
MD5 657011c809900907a6290ccca449175d
BLAKE2b-256 e49924c7bed827c26042e7128f39cbdeee0a8862c5b6dde9eb547c05bb55309f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for pymobiledevice3-9.15.2-py3-none-any.whl
Algorithm Hash digest
SHA256 03b764bffab3a0b84f2dda5d55109904c2b1f58c10f089dcfd2f4d5e73767f78
MD5 0f323602732ecd20499ea9760d1848b1
BLAKE2b-256 c0f0d12892d24a55e6336fde7ebb80a2b7d3837a7dda568fa1bac2742645b858

See more details on using hashes here.

Provenance

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