mirror of
https://github.com/LukeZGD/Legacy-iOS-Kit.git
synced 2024-12-23 23:01:49 +01:00
An all-in-one tool to restore/downgrade, save SHSH blobs, and jailbreak legacy iOS devices
3b01915462
Users can now drag restore.sh to terminal window |
||
---|---|---|
resources | ||
.gitattributes | ||
.gitignore | ||
README.md | ||
restore.sh |
iOS-OTA-Downgrader
(formerly 32bit-OTA-Downgrader)
Downgrade/restore iOS devices to signed OTA firmwares
- This is currently the only downgrade script/tool that supports both Linux and macOS
- 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:
- iPhones: iPhone 4S, iPhone 5
- iPads - iPad 2, iPad 3, iPad mini 1
- iPods - 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 (deb) 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
- Drag
restore.sh
to the Terminal window and press ENTER - Select option to be used
- Follow instructions
Supported OS versions/distros:
- Ubuntu 18.04 and Bionic-based distros
- Ubuntu 20.04 and Focal-based distros like Linux Mint 20
- Ubuntu 20.10
- Arch Linux and Arch-based distros like Manjaro
- Fedora 32 to 33
- macOS 10.13 to 10.15
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
- 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
- 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
- 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 does not modify the IPSW
- This script can work on virtual machines, but I won't provide support for them
Tools and other stuff used by this script:
- cURL
- bspatch
- ipwndfu
- iPwnder32
- 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