This guide is aimed to help you get OpeniBoot 0.2 running on your iPhone 2G, 3G or iPod Touch 1G.
OpeniBoot can be installed using Linux, OS X or on Windows.
Device and iOS Software
Currently OpeniBoot are compatible with the following devices:
- iPhone 2G
- iPhone 3G
- iPod Touch 1G (1st Generation)
OpeniBoot is compatible with iOS (also known as iPhone OS) up to to 4.1. iOS 4.2.1 is not yet compatible.
OpeniBoot requires a compatible jailbreak; one that allows for unsigned NOR images to be run. Currently these include redsn0w, PwnageTool or Blackra1n.
OpeniBoot will NOT work with the Spirit or Jailbreakme.com jailbreaks.
Preparing your computer's OS
These steps are designed for Linux users.
Type these commands into the terminal window (don't forget to enter your password when asked):
sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev libreadline6-dev readline-common libreadline6 libreadline-dev
Please note that the apt-get or aptitude command is only for Debian or Ubuntu distros. Use the appropriate command for your Linux distro, for example emerge or portage for Gentoo, yum for Fedora, and yast for Slackware distros.
OS X 10.6 Preparation
These steps are designed for users of OS X 10.6 (Snow Leopard).
Download and install the following package to your computer. These are required for loadibec and oibc to run.
Install usbreadline.mpkg.zip first then install libusb-mac.gz. Always make sure that libusb-mac.gz is the last to be installed. If you installed libusb-mac.gz first, install usbreadline.mpkg.zip then reinstall libusb-mac.gz.
""To be clearly install usbreadline.mpkg first THEN install libusb-mac.gz""
You need to have the Microsoft .NET Framework installed. Download it via Windows Update or from this link.
Download and Installation
1. Download the corresponding OpeniBoot 0.2 package to your computer depending on your iDevice:
- 2G is for iPhone 2G (not iPod Touch 2G), while 3G is for iPhone 3G (not iPod Touch 3G).
2. Extract the file (openiboot.img3) to a convenient location such as your Desktop
3. Depending on your Operating System, download the tools to install OpeniBoot from here:
- These tools have been improved and updated from the original ones created by planetbeing. For best results and optimum installation, it is advised to use the tools from the download link.
4. Extract/unzip the archive. You should end up with a folder named for your type of OS; i.e. Linux-x86 for 32-bit Linux, Linux-x86_64 for 64-bit Linux, OSX for Mac OS X 10.6, and windows for Microsoft Windows. Please note that the OS X tools were built using 10.6 Snow Leopard so they may or may not work on 10.5 Leopard.
5. Copy/Move the files from the folder extracted (corresponding to your OS) to the same convenient location where openiboot.img was extracted to (ex. Desktop).
6. The convenient location must contain: loadibec, oibc, openiboot.img3, and linux (if you are using 64-bit Linux). If you are using Windows, the folder must contain loadibec.exe, oibc.exe, README.txt, syringe.dll and 3 windows folders containing the drivers for iPhone OpeniBoot mode.
7. Open up a terminal or a command prompt and navigate to the convenient location containing loadibec, oibc, and openiboot.img3. The following is only an example command:
8. Turn off your device and place it in Recovery mode:
When the device is turned off, hold down the home button, then connect the USB cable (make sure that is connected to the PC), keep holding the home button until a screen with the iTunes logo and and a cable pointing towards it. For OS X and Windows users, don't forget to kill iTunesHelper or else iTunes will automatically open upon detecting an iDevice in Recovery Mode.
9. Go back to the terminal window and type the following command (don't forget to enter your password when asked):
sudo ./loadibec openiboot.img3
In Windows, enter the command (make sure you are in the same directory):
The device's screen should flash for a brief second and the OpeniBoot menu will load.
10. If you would like to test android before installing openiboot, simply navigate with the volume buttons (or power button if you are on iPod Touch 1G) to the android logo and press the home button. You will have to repeat the loading openiboot process in order to install it later.
11. Using the volume buttons (or power button if you are on iPod Touch 1G), navigate to the console selection (the cog icon) but don't press the home button yet.
12. In the terminal window type the following command:
Do not press enter yet - this is where your quick reflexes will pay off.
In Windows, enter:
An "Add Hardware Wizard" window will appear. Follow the instructions and point to the Windows folder with the iPhone OpeniBoot drivers. If ever a dialog box asks if you want to continue, continue anyway.
13. Press the home button on the device, wait 1 or 2 seconds and then press enter on your PC to send the command, this is necessary as there is a current problem with openiboot where the computer often does not connect to the device if the console screen has been on for a long time. You will know if the computer has failed to connect to the device if you receive only this output:
!<filename>[@<address>] to send a file, ~<filename>[@<address>]:<len> to receive a file ---------------------------------------------------------------------------------------------------------
The command will succeed if you see the OpeniBoot ASCII art on the terminal screen on your PC.
14. In the terminal window type this command:
- Note: If you get a error like this:
**ABORTED** Writing total image size: 0xeb240, new ibot size: 0x3b180 at 0x20000 would overflow NOR!
- Try to remove any custom bootlogo/recovery images by jailbreaking the device again without this option.
The install process should take around 30 seconds to 1 minute to complete. When completed, it will display this message on the iDevice: Openiboot installation complete. It may also display the message on the terminal screen on your PC.
This command will have also copied a file to your PC: norbackup.dump (usually a 1MB file). Keep this file in a safe location as it is the backup of the original bootloader, if the bootloader corrupts and you do not have this dump file, your device may become a very expensive paperweight.
15. Type this command in the terminal:
16. Your device should reboot and you shall be presented with the OpeniBoot menu again. Select the iOS option (press Power/volume buttons to select) and boot iOS by pressing the Home button.
Congratulations. You have installed OpeniBoot on your iOS Device. Remember to submit all issues and feature requests to the issue tracker at http://dev.idroidproject.org.
Adding an OS
OpeniBoot 0.1.2 and above uses the iOS directory /private/var/idroid, instead of /private/var like in previous OpeniBoot versions.
Make sure you place your OS images (iX, PS Freedom, iDroid) in /private/var/idroid. An empty idroid directory will cause OpeniBoot to boot into console mode when you select the Android boot option.