mirror of
https://github.com/LukeZGD/Legacy-iOS-Kit.git
synced 2024-11-27 18:34:14 +01:00
ce1d47c88a
- Recompile futurerestore and tsschecker again with static irecovery libs - Add compiled irecovery, libirecovery no longer needed to be compiled - Remove igetnonce - Remove unneeded depends
88 lines
4.8 KiB
Markdown
Executable File
88 lines
4.8 KiB
Markdown
Executable File
# 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](https://www.balena.io/etcher/) or [Rufus](https://rufus.ie/))
|
|
- All 32-bit users must install [OpenSSH](https://cydia.saurik.com/package/openssh/)
|
|
- A6/A6X iOS 10 users must install [Dropbear (deb)](https://github.com/LukeZGD/iOS-OTA-Downgrader-Keys/releases/download/tools/Dropbear.deb) as well
|
|
- For 32-bit users using Pangu, install the [latest Pangu 7.1.x Untether (deb)](http://apt.saurik.com/debs/io.pangu.axe7_0.3_iphoneos-arm.deb) or [latest Pangu 8.0-8.1.x Untether (deb)](http://apt.saurik.com/debs/io.pangu.xuanyuansword8_0.5_iphoneos-arm.deb)
|
|
1. [Download](https://github.com/LukeZGD/iOS-OTA-Downgrader/archive/master.zip) or `git clone` this repo
|
|
2. Open Terminal and `cd` to the directory where the script is located (example: `cd /home/user/iOS-OTA-Downgrader`)
|
|
3. Run `chmod +x restore.sh`
|
|
|
|
## How to use:
|
|
1. Plug in your iOS device
|
|
2. Run `./restore.sh`
|
|
3. Select option to be used
|
|
4. 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](http://releases.ubuntu.com/bionic/) and Bionic-based distros
|
|
- [Ubuntu 20.04](http://releases.ubuntu.com/focal/) and Focal-based distros like [Linux Mint 20](https://www.linuxmint.com/)
|
|
- [Arch Linux](https://www.archlinux.org/) and Arch-based distros like [Manjaro](https://manjaro.org/)
|
|
- [Fedora 32](https://getfedora.org/)
|
|
- macOS 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina
|
|
|
|
## Tools and other stuff used by this script:
|
|
- cURL
|
|
- bspatch
|
|
- [ipwndfu](https://github.com/LukeZGD/ipwndfu)
|
|
- [irecovery](https://github.com/LukeZGD/libirecovery)
|
|
- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)
|
|
- [imobiledevice-net](https://github.com/libimobiledevice-win32/imobiledevice-net) (macOS)
|
|
- python2
|
|
- [tsschecker](https://github.com/tihmstar/tsschecker)
|
|
- [futurerestore 152](http://api.tihmstar.net/builds/futurerestore/futurerestore-latest.zip) (32-bit)
|
|
- [futurerestore 251 (Linux)](https://github.com/LukeZGD/futurerestore) (A7)
|
|
- [futurerestore 245 (macOS)](https://github.com/MatthewPierson/Vieux/blob/master/resources/bin/futurerestore)
|
|
- [kloader](https://www.youtube.com/watch?v=fh0tB6fp0Sc)
|
|
- [kloader5 for iOS 5](https://mtmdev.org/pmbonneau-archive)
|
|
- [kloader_hgsp for iOS 10](https://twitter.com/nyan_satan/status/945203180522045440)
|
|
- [partial-zip](https://github.com/matteyeux/partial-zip)
|
|
- 32-bit iBSS patches are from [OdysseusOTA](https://www.youtube.com/watch?v=Wo7mGdMcjxw), [OdysseusOTA2](https://www.youtube.com/watch?v=fh0tB6fp0Sc), [alitek12](https://www.mediafire.com/folder/b1z64roy512wd/FirmwareBundles), [gjest](https://files.fm/u/fcbqqdnw)
|
|
- A7 iBSS and iBEC patches are from [MatthewPierson](https://github.com/MatthewPierson/iPhone-5s-OTA-Downgrade-Patches)
|