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]
d = AMDevice(dev)
d.connect()
afc = AFC(d)
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]
d = AMDevice(dev)
d.connect()
fr = FileRelay(d)
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]
d = AMDevice(dev)
d.connect()
sl = Syslog(d)
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