mirror of
https://github.com/LukeZGD/Legacy-iOS-Kit.git
synced 2024-12-24 15:21:49 +01:00
An all-in-one tool to restore/downgrade, save SHSH blobs, and jailbreak legacy iOS devices
f1247bbf21
- add restore custom ipsw option for 3gs and touch 2. there is also a warning to proceed with caution when doing so since legacy ios kit will never add support for tethered boots, downgrades, and jailbreaks (everything in legacy ios kit has to be untethered) - add optional arguments `--disable-sudoloop` and `--disable-usbmuxd` for linux. (i dont recommend enabling any of these since default behavior should work fine in most cases, maybe only `--disable-usbmuxd` will be useful in case, idk) - by default, legacy ios kit stops the usbmuxd service and starts up `sudo usbmuxd -pz`. `--disable-usbmuxd` disables this - by default, legacy ios kit runs some tools as root like irecovery and idevicerestore among others. `--disable-sudoloop` disables this |
||
---|---|---|
.github/workflows | ||
bin | ||
resources | ||
.gitattributes | ||
.gitignore | ||
LICENSE | ||
README.md | ||
restore.cmd | ||
restore.sh |
Legacy iOS Kit
- (formerly iOS-OTA-Downgrader)
- A multi-purpose script to save SHSH blobs, downgrade/restore, and jailbreak supported legacy iOS devices
- Linux, macOS, and Windows are supported
- Windows usage is not recommended
- Read the "How to Use" wiki page for usage instructions
- Read the "Troubleshooting" wiki page for tips, frequent questions, and troubleshooting
Features
- Restore to iOS 8.4.1 or 6.1.3 on supported 32-bit devices (OTA signed)
- Restore iPhone 4 GSM and CDMA (iPhone3,1 and 3,3) to lower iOS versions (powdersn0w)
- Restore iPhone 3GS and iPod touch 2 to lower iOS versions (24Kpwn/alloc8)
- Restore 32-bit devices to lower iOS versions with SHSH blobs
- Restore 32-bit devices to lower iOS versions with iOS 7.1.x blobs (powdersn0w)
- For iPhone 5 (not 5C), 7.0.x blobs can also be used
- Device support is limited, see below
- Option to jailbreak all of the above devices
- Including latest iOS versions for some devices (4.2.1, 5.1.1, 6.1.6, 7.1.2)
- There are two methods of jailbreaking: Custom IPSW and SSH Ramdisk
- Available on target versions 3.2.2, 4.0.x, 4.1, 4.2.x, 4.3.x, 5.x, 6.x, 7.x, and 8.4.1
- Jailbreaking iPad 2 on 4.3.x is not supported (only 5.x and newer will work)
- Restore to iOS 10.3.3 on supported A7 devices (OTA signed)
- Restore A7/A8 devices to lower iOS versions with SHSH blobs
- Limited compatibility due to SEP/BB, see below
- The latest baseband will be flashed for 32-bit devices if applicable
- Save onboard and Cydia SHSH blobs for 32-bit devices
- Place device to pwned iBSS/kDFU mode for supported devices
- Boot SSH Ramdisk on supported 32-bit devices
- Clear NVRAM for devices that support powdersn0w
- Device activation using ideviceactivation
Supported devices
- Identify your device here
- iPhone 5C and iPad mini 3 devices are NOT supported by OTA downgrades
- These devices still support restoring to other iOS versions with SHSH blobs, see below
- See the table below for OTA downgrading support:
Target Version | Supported Devices |
---|---|
iOS 10.3.3 | A7 devices: |
iPhone 5S | |
iPad Air 1 | |
iPad mini 2 (except iPad4,6) | |
iOS 8.4.1 | 32-bit devices: |
iPhone 4S | |
iPhone 5 | |
iPad 2, iPad 3, iPad 4 | |
iPad mini 1 | |
iPod touch 5 | |
iOS 6.1.3 | iPhone 4S |
iPad 2 (except iPad2,4) |
- Restoring with SHSH blobs and using SSH Ramdisks are supported on the following devices:
- Supports most 32-bit devices (iOS 3 to 10, version range depends on device)
- iPhone 3GS, 4, 4S, 5, 5C
- iPad 1, 2, 3, 4, mini 1
- iPod touch 2, 3, 4, 5
- S5L8900 devices will likely never be supported
- Restoring with SHSH blobs is also supported on most A7/A8 devices:
- See SEP/BB Compatibility Chart for iOS versions
- iPhone 5S, 6, 6 Plus
- iPad Air 1, mini 2, mini 3
- iPod touch 6
- Restoring with powdersn0w is supported on the following devices:
- iPhone 4 GSM - targets iOS 4.3 to 6.1.3
- iPhone 4 CDMA - targets iOS 5.0 to 6.1.3
- iPhone 4S, 5, 5C, iPad 2 Rev A, iPod touch 5 - targets iOS 5.0 to 9.3.5 (not iOS 7)
- Using powdersn0w requires iOS 7.1.x blobs for your device (7.0.x can also be used for iPhone 5)
- Restoring with 24Kpwn/alloc8 is supported on the following devices:
- iPhone 3GS - targets iOS 3.1.3 to 5.1.1
- iPod touch 2 - targets iOS 3.1.3 to 4.0
- Restoring to latest iOS version with jailbreak for the following devices:
- iPhone 4 - iOS 7.1.2 with Pangu
- iPhone 3GS, iPod touch 4 - iOS 6.1.6 with p0sixspwn
- iPad 1, iPod touch 3 - iOS 5.1.1 with pris0nbarake
- iPod touch 2 - iOS 4.2.1 with greenpois0n
Supported OS versions/distros
Supported architectures: x86_64, arm64, armhf
- Ubuntu 22.04 and newer, and Ubuntu-based distros like Linux Mint
- Arch Linux and Arch-based distros like EndeavourOS
- Fedora 36 and newer
- Debian 12 Bookworm and newer, Sid, and Debian-based distros
- openSUSE Tumbleweed
- Gentoo and Gentoo-based distros
- macOS 10.13 and newer
- Windows 8.1 and newer
Tools and other stuff used
- curl
- bspatch
- powdersn0w_pub - dora2ios; LukeZGD fork
- ipwndfu - axi0mX, Linus Henze, synackuk; LukeZGD fork
- ipwnder_lite - dora2ios (used on macOS)
- iPwnder32 - dora2ios (old version with libusb, used on Linux)
- gaster - 0x7ff
- daibutsuCFW - dora2ios; LukeZGD fork
- libimobiledevice - libimobiledevice
- libirecovery - libimobiledevice
- libideviceactivation - libimobiledevice
- tsschecker - tihmstar; 1Conan fork v413
- futurerestore - tihmstar;
- LukeZGD fork used on Linux for restoring 32-bit devices
- LukeeGD fork used on Linux/Windows for restoring A7/A8 devices
- iBoot32Patcher - dora2ios fork
- idevicerestore - libimobiledevice; LukeZGD fork
- idevicererestore from daibutsuCFW (used on custom IPSW restores for A5/A6 devices)
- kloader from Odysseus
- kloader from axi0mX (used on iOS 4/5 only)
- kloader_hgsp from nyan_satan (used on h3lix only)
- partial-zip
- zenity; macOS/Windows builds
- 32-bit bundles from OdysseusOTA, OdysseusOTA2, alitek12, gjest (modified bundles for daibutsuCFW)
- A7 patches from MatthewPierson
- iPad 2 iOS 4.3.x bundles from selfisht, Ralph0045
- sshpass
- Bootstrap tar from SpiritNET
- Pangu
- p0sixspwn
- unthredeh4il
- evasi0n
- pris0nbarake - LukeZGD fork
- greenpois0n
- Some patches from PwnageTool and sn0wbreeze
- SSH Ramdisk tar from SSH-Ramdisk-Maker-and-Loader and msftguy's ssh-rd