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

9.25.0

9.24.0

9.23.0

This version

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.22.0.tar.gz (880.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.22.0-py3-none-any.whl (914.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pymobiledevice3-9.22.0.tar.gz
  • Upload date:
  • Size: 880.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.22.0.tar.gz
Algorithm Hash digest
SHA256 d42f48cd111d89736eace69e4b2994b7c16a1c8a9427d51f36290694dccf4e46
MD5 4109554cbe40c12138038ae8a4d8bd60
BLAKE2b-256 e8a230a585f6e5f2c4ebde5281c05c9cd4400045769ea836d70f0c29dd6a6445

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for pymobiledevice3-9.22.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5d1de7c4c730d41dc02c91af476f05fa0bda5d19770e5ec6fe7bfc7fb2d530d4
MD5 569e4dd939720b5d94c0621d7733c400
BLAKE2b-256 bfd35aa98f21e95d699cd9c34bd2eeee8fe79bab7546055fa310e3e4a5aacf60

See more details on using hashes here.

Provenance

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