Skip to content
Back to search

pymobiledevice3

MarketplaceWorks with Claude CodeGitHub

Agent skills for operating iPhone and iPad (iOS/iPadOS) devices with pymobiledevice3.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/doronz88/pymobiledevice3 with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/doronz88/pymobiledevice3'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/doronz88--pymobiledevice3/badge.svg)](/listings/doronz88--pymobiledevice3)

HTML

<a href="/listings/doronz88--pymobiledevice3"><img src="/api/listings/doronz88--pymobiledevice3/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

python3 -m pip install -U pymobiledevice3

PyPI is the only official distribution channel. Third-party packages (for example the AUR's `python-pymobiledevice3`) are not maintained by this project and may be outdated.

Then verify connectivity:

pymobiledevice3 usbmux list
pymobiledevice3 syslog live
pymobiledevice3 apps list

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "pymobiledevice3",
  3. "description": "Agent skills for operating iPhone and iPad (iOS/iPadOS) devices with pymobiledevice3.",
  4. "owner": {
  5. "name": "doronz88",
  6. "url": "https://github.com/doronz88"
  7. },
  8. "plugins": [
  9. {
  10. "name": "pymobiledevice3-device-operator",
  11. "source": "./misc/claude-plugin",
  12. "description": "Operate iPhone and iPad (iOS/iPadOS) devices from Claude Code with pymobiledevice3: screenshots, syslog search, crash reports, file and app operations, developer services (DVT, tunnels, WebInspector, WDA) — works from a fresh workstation via uvx/PyPI or a local checkout."
  13. }
  14. ]
  15. }
README.md · README · 129 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # PyMobileDevice3
  2. <!-- markdownlint-disable MD013 -->
  3. [![Python application](https://github.com/doronz88/pymobiledevice3/workflows/Python%20application/badge.svg)](https://github.com/doronz88/pymobiledevice3/actions/workflows/python-app.yml "Python application action")
  4. [![Pypi version](https://img.shields.io/pypi/v/pymobiledevice3.svg)](https://pypi.org/project/pymobiledevice3/ "PyPi package")
  5. [![Python versions](https://img.shields.io/pypi/pyversions/pymobiledevice3)](https://pypi.org/project/pymobiledevice3/ "Supported Python versions")
  6. [![License](https://img.shields.io/pypi/l/pymobiledevice3)](https://github.com/doronz88/pymobiledevice3/blob/master/LICENSE "License")
  7. [![Docs](https://img.shields.io/badge/docs-online-blue)](https://doronz88.github.io/pymobiledevice3/ "Documentation")
  8. [![Downloads](https://static.pepy.tech/personalized-badge/pymobiledevice3?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/pymobiledevice3)
  9. [![Discord](https://img.shields.io/discord/1133265168051208214?logo=Discord&label=Discord)](https://discord.gg/52mZGC3JXJ)
  10. <!-- markdownlint-enable MD013 -->
  11. `pymobiledevice3` is a pure Python 3 implementation for interacting with iOS devices (iPhone, iPad, ...).
  12. It ships both a **command-line tool** and a **Python API**, and runs on Windows, Linux, and macOS. Coming
  13. from Android? Think of it as `adb` for iOS.
  14. Highlights:
  15. - [Screen mirroring and control](https://doronz88.github.io/pymobiledevice3/guides/screen-mirroring/) in any
  16. browser or VNC client, with touch, buttons, keyboard, audio and clipboard (iOS 27+)
  17. - [Per-process packet capture](https://doronz88.github.io/pymobiledevice3/guides/packet-capture/) straight into Wireshark
  18. - [strace-style syscall tracing](https://doronz88.github.io/pymobiledevice3/guides/kdebug/) of every process, live
  19. - A [JavaScript shell and a CDP bridge](https://doronz88.github.io/pymobiledevice3/guides/webview-debugging/) for
  20. Safari and WebViews (Chrome DevTools, VS Code, Playwright)
  21. - Developer services without Xcode (screenshots, location simulation, sysmon, DDI mounting); on iOS 17+ over a
  22. no-root tunnel each command builds for you, on Windows and Linux too
  23. - Syslog/oslog, apps & profiles, device files, crash reports, backups, firmware update/restore and recovery/DFU
  24. ## Install
  25. Install with [uv](https://docs.astral.sh/uv/), which fetches a suitable Python for you and puts
  26. `pymobiledevice3` on your PATH:
  27. ```shell
  28. # macOS / Linux
  29. curl -LsSf https://astral.sh/uv/install.sh | sh
  30. # Windows (PowerShell)
  31. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  32. # then, in a new terminal
  33. uv tool install --managed-python pymobiledevice3
  34. ```
  35. Upgrade later with `uv tool upgrade pymobiledevice3`, or try it without installing via
  36. `uvx --managed-python pymobiledevice3 usbmux list`. Already manage Python yourself? `pipx install pymobiledevice3`
  37. works too, and for scripting against the [Python API](https://doronz88.github.io/pymobiledevice3/guides/python-api/)
  38. `pip install pymobiledevice3` inside your project's virtualenv.
  39. PyPI is the only official distribution channel. Third-party packages (for example the AUR's
  40. `python-pymobiledevice3`) are not maintained by this project and may be outdated.
  41. On Windows and Linux, first install the
  42. [platform prerequisites](https://doronz88.github.io/pymobiledevice3/installation/#platform-notes)
  43. (iTunes or `usbmuxd`). Then connect the device by USB, unlock it, and verify connectivity:
  44. ```shell
  45. pymobiledevice3 usbmux list # lists connected devices
  46. pymobiledevice3 apps list # first device command: tap "Trust" on the device if asked
  47. pymobiledevice3 syslog live # streams the device log; Ctrl+C to stop
  48. ```
  49. ## Documentation
  50. 📖 **Full documentation: <https://doronz88.github.io/pymobiledevice3/>**
  51. - [Installation & platform notes](https://doronz88.github.io/pymobiledevice3/installation/)
  52. - [CLI recipes](https://doronz88.github.io/pymobiledevice3/guides/cli-recipes/)
  53. - [iOS 17+ tunnels & support matrix](https://doronz88.github.io/pymobiledevice3/guides/ios17-tunnels/)
  54. - [Python API guide](https://doronz88.github.io/pymobiledevice3/guides/python-api/)
  55. - [Python API reference](https://doronz88.github.io/pymobiledevice3/api/)
  56. - [Protocol internals (RemoteXPC, DTX, iDevice layers)](https://doronz88.github.io/pymobiledevice3/internals/idevice-protocol-layers/)
  57. The docs are built from [`docs/`](docs/) with MkDocs (`mkdocs.yml`).
  58. ## Claude Code plugin
  59. The repository ships its
  60. [device-operator agent skill](https://doronz88.github.io/pymobiledevice3/guides/codex-device-operator-skill/)
  61. as a Claude Code plugin, teaching the agent to operate a connected iPhone or iPad through pymobiledevice3:
  62. ```
  63. /plugin marketplace add doronz88/pymobiledevice3
  64. /plugin install pymobiledevice3-device-operator@pymobiledevice3
  65. ```
  66. ## Community
  67. Questions, ideas, or want to help? Join the community on [Discord](https://discord.gg/52mZGC3JXJ).
  68. ## Sponsors
  69. A huge thank you to our sponsors for supporting this project! 💖
  70. <!-- markdownlint-disable MD013 -->
  71. <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=doron">
  72. <picture>
  73. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/doronz88/pymobiledevice3/18b75e567decdb4d1f0a213ec92ba014fa35d1c0/misc/sponsors/testmu-ai-dark.svg">
  74. <img alt="TestMu AI (formerly LambdaTest)" src="https://raw.githubusercontent.com/doronz88/pymobiledevice3/18b75e567decdb4d1f0a213ec92ba014fa35d1c0/misc/sponsors/testmu-ai.svg" width="320">
  75. </picture>
  76. </a>
  77. <!-- markdownlint-enable MD013 -->
  78. [![TestingBot](https://github.com/testingbot.png?size=48)](https://testingbot.com) [**TestingBot**](https://testingbot.com)
  79. [![SmartDust](https://github.com/smartdust-me.png?size=48)](https://smartdust.me) [**SmartDust**](https://smartdust.me)
  80. [![AnNEDoMini](https://github.com/AnNEDoMini.png?size=48)](https://github.com/AnNEDoMini) [**AnNEDoMini**](https://github.com/AnNEDoMini)
  81. Want to support the project as well? Sponsor it via [GitHub Sponsors](https://github.com/sponsors/doronz88) or
  82. [Ko-fi](https://ko-fi.com/doronz).
  83. ## Contributing
  84. See [CONTRIBUTING](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
  85. Agent-specific contributor guidance is in [AGENTS](AGENTS.md).
  86. ## License and Credits
  87. This work is licensed under GPL 3.0. Planning to ship it in a closed-source app? Read
  88. [this FAQ](https://doronz88.github.io/pymobiledevice3/#can-i-use-pymobiledevice3-in-a-closed-source-app)
  89. first. The project is credited to several major contributors:
  90. - Hector Martin "marcan" <hector@marcansoft.com>
  91. - Mathieu Renard
  92. - [doronz](https://github.com/doronz88) <doron88@gmail.com>
  93. - [matan1008](https://github.com/matan1008) <matan1008@gmail.com>
  94. - [Guy Salton](https://github.com/guysalt)
  95. - [netanelc305](https://github.com/netanelc305) <netanelc305@protonmail.com>
  96. - Inbar Agmon <inbar2812@gmail.com> ([Project's logo](https://repository-images.githubusercontent.com/357904774/6d6fb035-5953-425d-9afd-cc1087df0cfb))

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.