Skip to main content

python implementation for libimobiledevice library

Project description


GitHub license

pymobiledevice is a cross-platform implementation of the mobiledevice library that talks the protocols to support iPhone®, iPod Touch®, iPad® and Apple TV® devices.


  • Python 2.7 and 3.x
  • M2Crypto
  • construct >= 2.9.29
  • pyasn1
  • future
  • six
  • biplist []

This script can be used in order to pair with the device & starts other services.

/!\ Others services can only being accessed after succesful pairing. Succesful pairing requiert the device to be unlocked and user to click on "Trust this device" on its phone screen. []

This service is responsible for things such as copying music and photos. AFC Clients like iTunes are allowed accessing to a “jailed” or limited area of the device filesystem. Actually, AFC clients can only access certain files, namely those located in the Media folder. []

This service allows accessing to AppStore applications folders and their content. In other words, by using an AFC client, a user/attacker can download the application resources and data. It also includes the “default preferences” file where credentials are sometimes stored. []

The installation proxy manages applications on a device. It allows execution of the following commands:

  • List installed applications
  • List archived applications
  • ... & [ & ]

Those services are used by iTunes to backup the device. []

The diagnostic relay allows requesting iOS diagnostic information. The service handles the following actions:

  • [ Sleep ]Puts the device into deep sleep mode and disconnects from host.
  • [ Restart ] Restart the device and optionally show a user notification.
  • [ Shutdown ] Shutdown of the device and optionally show a user notification.
  • [ NAND, IORegistry, GasGauge, MobileGestalt ] Querry diagnostic informations.
  • ... []

Depending of the iOS version, the file relay service may support the following commands: Accounts, AddressBook, AppleSupport, AppleTV, Baseband, Bluetooth, CrashReporter, CLTM Caches, CoreLocation, DataAccess, DataMigrator, demod, Device-o-Matic, EmbeddedSocial, FindMyiPhone GameKitLogs, itunesstored, IORegUSBDevice, HFSMeta, Keyboard, Lockdown, MapsLogs, MobileAsset, MobileBackup, MobileCal, MobileDelete, MobileInstallation, MobileMusicPlayer, MobileNotes, NANDDebugInfo Network, Photos, SafeHarbor, SystemConfiguration, tmp, Ubiquity, UserDatabases, VARFS, VPN, Voicemail WiFi, WirelessAutomation.

All the files returned by the iPhone are stored in clear text in a gziped CPIO archive. []

Starting iOS 5, apple added a remote virtual interface (RVI) facility that allows mirroring networks trafic from an iOS device. On Mac OSX the virtual interface can be enabled with the rvictl command. This script allows to use this service on other systems.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymobiledevice-1.2.0.tar.gz (50.2 kB view hashes)

Uploaded source

Built Distributions

pymobiledevice-1.2.0-py3-none-any.whl (84.5 kB view hashes)

Uploaded py3

pymobiledevice-1.2.0-py2.7.egg (5.8 MB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page