Installation¶

From PyPI¶

python3 -m pip install -U pymobiledevice3

From source¶

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

Requires Python 3.9+.

Verify connectivity¶

pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list

Install shell completions:

pymobiledevice3 install-completions

Platform notes¶

WindowsLinuxmacOS

Install iTunes from the Microsoft Store: https://apps.microsoft.com/detail/9pb2mz1zmb1s
For WSL2, enable mirrored networking mode:
```
[wsl2]
networkingMode=mirrored
```

Install usbmuxd: https://github.com/libimobiledevice/usbmuxd

Works out of the box with the system usbmuxd.

Additional requirements:

OpenSSL is explicitly required for older iOS versions (< 13).
Recovery/DFU support requires libusb.

iOS 17+ developer services¶

iOS >= 17 developer services require tunnel-based transport. The tunnel normally needs root/admin; you can instead add --userspace to a developer command for a no-root, in-process tunnel. See iOS 17+ tunnels for the full picture and the support matrix.