INSTALLATION ================================================================================ For: Apple iPhone/iPod Touch + iPod USB cable You must have: libiphone libfuse-dev (and the associated kernel modules) libglib2.0-dev make autoheader automake autoconf gcc To compile run: ./autogen.sh ./configure make sudo make install # (if you want to install it into your system directories) On Ubuntu/Debian, you can do: sudo apt-get install build-essential automake autoconf \ libfuse-dev libglib2.0-dev (make sure that you have compiled libiphone first) USAGE ================================================================================ Now comes the fun bit! To mount: $ ifuse Note: If you mount your device as regular user, system migth complain that file /etc/fuse.conf is not readable. It means you do not belong to the 'fuse' group (see below). To unmount you do: $ fusermount -u By default, iFuse (via the AFC protocol) gives access to the '/var/root/Media/' chroot on the iPhone (containing music/pictures). This is the right and safe way to access the device. However, if the device has been jailbroken, a full view of the iPhone's filesystem might be available using the following command when mounting: $ ifuse --root Note that only PwnageTool and older jailbreak software installs the necessary AFC2 service on the device to enable root filesystem usage. For instance blackra1n does not install it and thus does not enable root filesystem access! Use with care as the AFC protocol was not made to access the root filesystem. Addtional help can be shown using: $ ifuse --help ==== Setting up FUSE ==== Note that on some systems, you may have to load the 'fuse' kernel module first and to ensure that you are a member of the 'fuse' group: sudo modprobe fuse sudo adduser $USER fuse You can check your membership of the 'fuse' group with: id | grep fuse && echo yes! || echo not yet... If you have just added yourself, you will need to logout and log back in for the group change to become visible. == Who/what/where? == wiki: http://matt.colyer.name/projects/iphone-linux/ code: git clone git://github.com/MattColyer/ifuse.git tickets: http://libiphone.lighthouseapp.com/ mailing list: http://lists.mattcolyer.com/listinfo.cgi/iphone-linux-dev-mattcolyer.com Credits ======= Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc. ifuse is an independent software program and has not been authorized, sponsored, or otherwise approved by Apple Inc. README updated on: 2010-01-30