Legacy-iOS-Kit/HOW-TO-USE.md

Section 0 - Things to note before you begin

• Some of the sections and steps will be separated depending on your platform and device.
• Make sure that your OS version/distro and your iOS device are compatible before proceeding.
• The restore will ERASE ALL DATA on your iOS device. Backup your data before proceeding.
• Make sure to have at least 10 GB of free space on your PC/Mac.
• For A7 devices, Windows support is limited. Read TROUBLESHOOTING.md for more details.
• Restoring to other versions with SHSH blobs is not supported on Windows.

Section 1.1 - Setup for PC/Mac

Windows

1. Your installation of Windows must be 64-bit. Windows 8.1 and 10 are supported, but Windows 7 may also work.
2. Install iTunes, version 12.10.11 or newer. Make sure to not install the Microsoft Store version.
3. Install MSYS2, follow steps 1 to 4 only. In step 4, untick "Run MSYS2 64-bit now" before clicking Finish.
4. Download iOS-OTA-Downgrader and extract the zip archive.
5. Go to where the extracted files are located, and run restore.cmd
   • It may only show up as restore. If this is the case, run the one that has the gears icon. I recommend to make Windows show file extensions to avoid confusion.
6. On its first run, it will download and install dependencies. This will take some time depending on your Internet connection. When it's done, proceed to the next section.

macOS/Linux

1. Download iOS-OTA-Downgrader and extract the zip archive. (it will be extracted automatically if downloaded from Safari)
2. Open a Terminal window. (for macOS, here's how)
3. Go to where the extracted files are located, and drag restore.sh to the Terminal window, and press Enter.
4. On its first run, it will download and install dependencies. This will take some time depending on your Internet connection. When it's done, proceed to the next section.

Section 1.2 - Setup for iOS device

32-bit devices

1. Jailbreak your device.
   • For alternatives, the DFU advanced menu can also be used. Read TROUBLESHOOTING.md for more details
2. Open Cydia, and wait for sources to refresh.
3. When it asks to upgrade, tap Upgrade Essential. After the upgrade, Cydia will crash.
4. Open Cydia again, go to Search, and search for OpenSSH.
5. When OpenSSH shows up, tap and install it.
   • If you have an iPhone 5 or an iPad 4 on iOS 10, do the additional steps below. Otherwise, proceed to the next section.
6. Go to Sources, tap Edit at the top right, then tap Add at the top left.
7. Add this repository: https://lukezgd.github.io/repo/
8. After the repo is added, go to Search, and search for Dropbear.
9. When Dropbear shows up, tap and install it. When it's done, proceed to the next section.

A7 devices

1. No prior setup is needed. Proceed to the next section.

Section 2 - Downgrading the device

32-bit devices

1. Connect your iOS device to your PC/Mac. Make sure to also trust the computer by tapping "Trust" at the pop-up.
   • Windows/macOS: Double-check if the device is being detected by iTunes/Finder.
2. Run the script.
   • Windows: Go to where the extracted files are located, and run restore.cmd (the one that has the gears icon)
   • macOS/Linux: Go to where the extracted files are located, and drag restore.sh to the Terminal window, and press Enter/Return.
3. When the main menu shows up, type '1' and press Enter/Return to select Downgrade device.
4. Select your target version and options, and follow the instructions that the script will give you.
5. After the restore process, your device will be successfully in your selected target version.
   • Windows: The restore process may give out an error on your first try. If this happens, follow the steps in TROUBLESHOOTING.md

A7 devices

1. Connect your iOS device to your PC/Mac.
2. Run the script.
   • Windows: Take note of the limited support on Windows before proceeding. More details in TROUBLESHOOTING.md
   • macOS/Linux: Go to where the extracted files are located, and drag restore.sh to the Terminal window, and press Enter/Return.
3. Let the script put the device to recovery mode, and follow the steps to enter DFU mode.
4. When in DFU mode, wait for the script will put the device to pwnDFU mode.
   • Linux: Entering pwnDFU mode can fail a lot on Linux. Read TROUBLESHOOTING.md for more details
5. When the main menu shows up, type '1' and press Enter/Return to select Downgrade device.
6. Select your target version and options, and follow the instructions that the script will give you.
7. After the restore process, your device will be successfully in iOS 10.3.3.