Legacy-iOS-Kit/README.md

88 lines
4.8 KiB
Markdown
Raw Normal View History

# iOS-OTA-Downgrader
### (formerly 32bit-OTA-Downgrader)
### Downgrade/restore iOS devices to signed OTA firmwares
2020-08-22 03:52:58 +02:00
- **Please see the "Other notes" section below to serve as answers/solutions for FAQs and issues**
2020-04-01 14:12:36 +02:00
## Supported devices:
2020-03-13 05:12:49 +01:00
2020-08-21 01:02:00 +02:00
- **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**
2020-03-13 05:12:49 +01:00
2020-02-08 16:19:36 +01:00
## Prerequisites:
2020-08-21 01:02:00 +02:00
- **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)
2020-08-10 16:08:15 +02:00
- 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/))
2020-07-31 11:24:32 +02:00
- All 32-bit users must install [OpenSSH](https://cydia.saurik.com/package/openssh/)
2020-08-10 16:08:15 +02:00
- A6/A6X iOS 10 users must install [Dropbear (deb)](http://www.mediafire.com/file/m2wzque7zsa87lp/Dropbear.deb/file) 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
2020-08-10 16:08:15 +02:00
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`
2020-02-08 16:19:36 +01:00
## How to use:
1. Plug in your iOS device
2. Run `./restore.sh`
3. Select option to be used
4. Follow instructions
2020-01-06 15:45:55 +01:00
2020-02-08 16:19:36 +01:00
## Other notes:
- **You do NOT need blobs to use this**, the script will get them for you
2020-08-10 16:08:15 +02:00
- 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`
2020-08-10 16:08:15 +02:00
- 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)
2020-08-10 16:08:15 +02:00
- If the script can't find your device in pwnREC mode or gets stuck, you may have to start over
- For 32-bit devices:
2020-07-23 02:56:03 +02:00
- 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
2020-08-10 16:08:15 +02:00
- This script can also restore your device to other iOS versions with provided SHSH blobs
2020-07-23 02:56:03 +02:00
- This script can work on virtual machines, but I won't provide support for them
2019-11-20 13:39:56 +01:00
2020-08-10 16:08:15 +02:00
## Supported OS versions/distros:
2020-08-14 10:07:14 +02:00
- [Ubuntu 18.04](http://releases.ubuntu.com/bionic/) and Bionic-based distros
2020-08-10 16:08:15 +02:00
- [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/)
2020-07-06 10:08:13 +02:00
- [Fedora 32](https://getfedora.org/)
2020-08-10 16:08:15 +02:00
- macOS 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina
2020-02-08 16:19:36 +01:00
2020-03-13 05:12:49 +01:00
## Tools and other stuff used by this script:
2019-11-20 13:39:56 +01:00
- cURL
2020-04-01 14:12:36 +02:00
- bspatch
- [igetnonce](https://github.com/LukeZGD/igetnonce)
- [ipwndfu](https://github.com/LukeZGD/ipwndfu)
2020-08-16 13:31:50 +02:00
- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)
- [imobiledevice-net](https://github.com/libimobiledevice-win32/imobiledevice-net) (macOS)
- python2
2020-08-21 01:02:00 +02:00
- [tsschecker](https://github.com/tihmstar/tsschecker)
2020-07-30 07:23:30 +02:00
- [futurerestore 152](http://api.tihmstar.net/builds/futurerestore/futurerestore-latest.zip) (32-bit)
2020-07-23 02:56:03 +02:00
- [futurerestore 249 (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)
2020-04-01 14:12:36 +02:00
- [kloader5 for iOS 5](https://mtmdev.org/pmbonneau-archive)
- [kloader_hgsp for iOS 10](https://twitter.com/nyan_satan/status/945203180522045440)
2020-08-16 13:25:32 +02:00
- [partial-zip](https://github.com/matteyeux/partial-zip)
2020-07-23 02:56:03 +02:00
- 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)