mirror of
https://github.com/LukeZGD/Legacy-iOS-Kit.git
synced 2024-11-27 10:24:16 +01:00
An all-in-one tool to restore/downgrade, save SHSH blobs, and jailbreak legacy iOS devices
resources | ||
.gitattributes | ||
.gitignore | ||
README.md | ||
restore.sh |
iOS-OTA-Downgrader
(formerly 32bit-OTA-Downgrader)
Downgrade/restore and jailbreak iOS devices to signed OTA firmwares
- This downgrade script/tool supports both Linux and macOS
- iOS 8.4.1 and 6.1.3 downgrades have the option to jailbreak
- For iOS 10.3.3, use TotallyNotSpyware
- You do NOT need blobs to use this, the script will get them for you
- This script can also restore your device to other iOS versions that you have SHSH blobs on (for 32-bit devices only)
- Please see the "Other notes" section below to serve as answers/solutions for frequent questions and issues
Supported devices:
- You can identify your device here
- iOS 10.3.3 - A7 devices:
- iPhone 5S
- iPad Air 1
- iPad mini 2 except iPad4,6
- iPad mini 3 is NOT supported
- iOS 8.4.1 - 32-bit devices:
- iPhone 4S, iPhone 5
- iPad 2, iPad 3, iPad 4, iPad mini 1
- iPod 5th gen
- iPhone 5C is NOT supported
- iOS 6.1.3:
- iPhone 4S
- iPad 2 except iPad2,4
Requirements:
- A supported device in any iOS version:
- A 32-bit iOS device (jailbreak needed)
- An A7 device (jailbreak not needed)
- An IPSW for the version you want to downgrade to
- Links: iOS 10.3.3, iOS 8.4.1, iOS 6.1.3
- The script can also download it for you
- A 64-bit Linux install/live USB or a supported macOS version
- See supported OS versions and Linux distros below
- A Linux live USB can be easily created with tools like balenaEtcher or Rufus
- All 32-bit users must install OpenSSH
- Users in iOS 10 must install Dropbear (Cydia repo) as well
For Pangu 32-bit users:
- For 32-bit users using Pangu, install the latest untether for your iOS version here
How to use:
- Download iOS-OTA-Downgrader here and extract the zip archive
- Plug in your iOS device
- Open a Terminal window
cd
to where the zip archive is extracted, and run./restore.sh
- You can also drag
restore.sh
to the Terminal window and press ENTER
- You can also drag
- Select option to be used
- Follow instructions
Supported OS versions/distros:
- Ubuntu 16.04, 18.04, 20.04, and 20.10 and Ubuntu-based distros like Linux Mint
- Arch Linux and Arch-based distros like Manjaro
- Fedora 32 to 33
- macOS 10.13 to 10.15
Other notes:
- If something in the process does not work for you, try switching USB ports and/or cables (using a USB 2.0 port is recommended)
- This script will verify the IPSW SHA1sum before restoring
- For users having issues related to missing libraries or tools, re-install dependencies with
./restore.sh Install
- For A7 devices:
- Do not use USB-C to lightning cables as this can prevent a successful restore
- checkm8 ipwndfu is unfortunately pretty unreliable, you may have to try multiple times (for Linux users I recommend trying in a live USB)
- If the script can't find your device in pwnREC mode or gets stuck, you may have to start over
- Other than the above there's not much else I can help regarding entering pwnDFU mode...
- For 32-bit devices:
- To devices with baseband, this script will restore your device with the latest baseband (except when jailbreak is enabled, and on iPhone5,1 as there are reported issues)
- This script has a workaround for the activation error on devices downgrading from iOS 10
- This script can also be used to just enter kDFU mode for all supported devices
- As alternatives to kloader/kDFU, checkm8 A5 or ipwndfu can also be used in DFU advanced menu
- To enter DFU advanced menu, put your iOS device in DFU mode before running the script
- This script can work on virtual machines, but I won't provide support for them
- If you have problems with Cydia, remove the ultrasn0w repo and force-close Cydia, then try opening Cydia again
- For jailbreak option on iOS 8 downgrades:
- Stashing is already enabled and
nosuid
is removed fromfstab
, so no need to install "Stashing for #etasonJB" package - If you can't find Cydia in your home screen, try accessing Cydia through Safari with
cydia://
and install "Jailbreak App Icons Fix" package (Cydia repo) - To fix LaunchDaemons not loading on startup, install "Infigo" package (Cydia repo)
- Warning: If your device bootloops with EtasonJB, it may not work with the jailbreak option as well! (I think this applies to some but not all 8942/8945 users) If this happens, bootloop protection will trigger and you won't be able to open Cydia
- Stashing is already enabled and
Tools and other stuff used by this script:
- cURL
- bspatch
- ipwndfu
- iPwnder32
- irecovery
- libimobiledevice
- imobiledevice-net (macOS)
- idevicerestore
- ipsw tool from OdysseusOTA/2
- python2
- tsschecker
- futurerestore 152 (32-bit)
- futurerestore 251 (Linux) (A7)
- futurerestore 245 (macOS) (A7)
- kloader
- kloader5 for iOS 5
- kloader_hgsp for iOS 10
- partial-zip
- 32-bit iBSS patches are from OdysseusOTA, OdysseusOTA2, alitek12, gjest
- A7 iBSS and iBEC patches are from MatthewPierson