An all-in-one tool to restore/downgrade, save SHSH blobs, and jailbreak legacy iOS devices
Go to file
LukeZGD f1247bbf21 Custom IPSW restore option, optional Linux args
- 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
2023-07-01 22:14:19 +08:00
.github/workflows Huge update (3GS/touch 2 downgrades, etc) 2023-06-15 14:21:05 +08:00
bin Update macos bins, add jailbreaking w/ sshrd 2023-06-24 18:22:35 +08:00
resources Update some tars 2023-06-30 18:24:07 +08:00
.gitattributes Added all files from iOS-OTA-Downgrader-Keys 2021-10-07 21:50:26 +08:00
.gitignore Update macos bins, add jailbreaking w/ sshrd 2023-06-24 18:22:35 +08:00
LICENSE Big update (script rewrite) 2023-01-13 12:25:27 +08:00
README.md Fix baseband dumping, update daibutsuCFW support 2023-06-30 14:02:18 +08:00
restore.cmd Legacy iOS Kit 2023-04-02 18:18:44 +08:00
restore.sh Custom IPSW restore option, optional Linux args 2023-07-01 22:14:19 +08:00

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:
  • 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

Tools and other stuff used