mirror of
https://github.com/LukeZGD/Legacy-iOS-Kit.git
synced 2024-12-28 01:01:50 +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 iOS devices to signed OTA firmwares
- Please see the "Other notes" section below to serve as answers/solutions for FAQs and issues
Supported devices:
- iOS 10.3.3 - A7 devices:
- iPhone 5S
- iPad Air
- 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 mini 1
- iPod 5th gen
- iPhone 5C is NOT Supported
- iOS 6.1.3:
- iPhone 4S
- iPad 2 except iPad2,4
Prerequisites:
- A supported device in any iOS version:
- A 32-bit iOS device (jailbreak needed for kloader, checkm8 A5 or ipwndfu can also be used in DFU advanced menu)
- An A7 device (jailbreak not needed)
- An IPSW for the version you want to downgrade to (the script can also download it for you)
- A macOS or a 64-bit Linux install/live USB
- See supported Linux distros below
- A live USB can be easily created with tools like balenaEtcher or Rufus)
- All 32-bit users must install OpenSSH
- A6/A6X iOS 10 users must install Dropbear (deb) as well
- For 32-bit users using Pangu, install the latest Pangu 7.1.x Untether (deb) or latest Pangu 8.0-8.1.x Untether (deb)
- Download or
git clone
this repo - Open Terminal and
cd
to the directory where the script is located (example:cd /home/user/iOS-OTA-Downgrader
) - Run
chmod +x restore.sh
How to use:
- Plug in your iOS device
- Run
./restore.sh
- Select option to be used
- Follow instructions
Other notes:
- You do NOT need blobs to use this, the script will get them for you
- If the restore process does not work for you, try switching USB ports and/or cables
- 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
- For 32-bit devices:
- This script does not modify the IPSW
- To devices with baseband, this script will restore your device with the latest baseband
- 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
- This script can also restore your device to other iOS versions with provided SHSH blobs
- This script can work on virtual machines, but I won't provide support for them
Supported OS versions/distros:
- Ubuntu 18.04 and Bionic-based distros
- Ubuntu 20.04 and Focal-based distros like Linux Mint 20
- Arch Linux and Arch-based distros like Manjaro
- Fedora 32
- macOS 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina
Tools and other stuff used by this script:
- cURL
- bspatch
- ipwndfu
- irecovery
- libimobiledevice
- imobiledevice-net (macOS)
- python2
- tsschecker
- futurerestore 152 (32-bit)
- futurerestore 251 (Linux) (A7)
- futurerestore 245 (macOS)
- 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