Legacy-iOS-Kit/README.md

iOS-OTA-Downgrader

• A multi-purpose script to downgrade/restore and jailbreak supported legacy iOS devices
• iPhone4Down: Downgrade iPhone 4 GSM on Linux/Windows (using powdersn0w)
• Linux, macOS, and Windows are supported
  • Windows usage is not recommended
• Read the "How to Use" wiki page for a step-by-step tutorial
• Read the "Troubleshooting" wiki page for tips, frequent questions, and troubleshooting

Other features

• Option to jailbreak iOS 6.1.3 and 8.4.1 downgrades
  • For iOS 10.3.3 downgrades, use TotallyNotSpyware
• Restore to other iOS versions with SHSH blobs (32-bit/A7/A8 devices, iOS 5 to 12)
• The latest baseband will be used for 32-bit devices if applicable
• Place device to pwned iBSS/kDFU mode for 32-bit devices
• Clear NVRAM for iPhone 4 GSM (Disable/Enable Exploit)
• Restore iPhone 4 to iOS 7.1.2 with the option to jailbreak
• Restore supported devices to their latest iOS version
• Save on-board and Cydia SHSH blobs for 32-bit devices

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
• iPhone4Down (downgrading without blobs) supports iPhone 4 GSM only (iPhone3,1)
  • All iPhone 4 models still support restoring with SHSH blobs and to iOS 7.1.2

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)
iOS 7.1.2	iPhone 4 (all models)
iOS 4.3 to 6.1.3	iPhone 4 GSM

For 32-bit devices jailbroken with Pangu:

• For 32-bit devices using Pangu and jailbroken method, install the latest untether for your iOS version here

Supported OS versions/distros

Supported architectures: x86_64, arm64, armhf (Linux)

• 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 - 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, libirecovery - libimobiledevice
• tsschecker - tihmstar; 1Conan fork
• futurerestore - tihmstar;
  • LukeZGD fork used on Linux for restoring 32-bit devices
  • LukeeGD fork used on Linux/Windows for restoring A7/A8 devices
  • futurerestore version used on macOS
• idevicerestore - libimobiledevice; LukeZGD fork
• idevicererestore from daibutsuCFW (used on custom IPSW restores for A5/A6 devices)
• kloader
• kloader5 for iOS 5
• kloader_hgsp for iOS 10 (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
• EtasonJB
• Pangu
• p0sixspwn
• unthredeh4il