A python package which aims to wrap Apple's MobileDevice API; to provide complete support for all iOS, device services.

The project aims to provide both a native Pythin API (using ctypes) and a fully features command line interface.

You can run the project directory as a package e.g.

python MobileDevice/ afc put myfile.txt /var/mobile/Media/

or:

python MobileDevice.zip afc put myfile.txt /var/mobile/Media/

or, if you install the library using: sudo python setup.py install

mdf afc put myfile.txt /var/mobile/Media/

(will upload a file to the device)

at any point append -h to the command line to get more help

In general I recommend you install the package if you're ever going to write scripts using it, or just fancy typing less characters.

The basic structure of the package is as follows:

MobileDevice.py: this is a bare bones ctypes wrapper over the native C library

CoreFoundation.py: this is a simple ctypes wrapper around CoreFoundation and a few helper methods to convert between CFTypes and python types

All other classes: afc.py, syslog.py, filerelay.py, amdevice.py etc are more pythonic wrappers around the base C library.

The idea being that we give a python abstraction of all the services e.g.

from command line:

mdf afc ls /var/mobile/Media

or in code:

from MobileDevice import * def printdir(afc, path): for name in afc.listdir(path): isdir = u'' if afc.lstat(path + name).st_ifmt == stat.S_IFDIR: isdir = u'/' print path + name + isdir if afc.lstat(path + name).st_ifmt == stat.S_IFDIR: printdir(afc, path + name + isdir) dev = list_devices()[0] dev.connect() afc = AFC(dev) printdir(afc, u'/var/mobile/Media') # recursive print of all files visible afc.disconnect() 

from command line:

mdf filerelay dump.cpio.gz

or in code:

from MobileDevice import * dev = list_devices()[0] dev.connect() fr = FileRelay(dev) f = open(u'dump.cpio.gz', 'wb') f.write(fr.retrieve([ u'AppleSupport', u'Network', u'VPN', u'WiFi', u'UserDatabases', u'CrashReporter', u'tmp', u'SystemConfiguration' ])) f.close() fr.disconnect() 

from command line:

mdf syslog

or in code:

from MobileDevice import * import sys dev = list_devices()[0] dev.connect() sl = Syslog(dev) while True: msg = sl.read() if msg is None: break sys.stdout.write(msg) sl.disconnect() 

iOS, iPad, iPhone, Apple, MobileDevice, python, command line, lockdownd, usbmuxd