Skip to content

iOS upgrade and downgrade tool utilizing SHSH blobs (unofficial fork)

License

Notifications You must be signed in to change notification settings

rhaym-jailbreak/futurerestore

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

futurerestore

futurerestore is a hacked up idevicerestore wrapper, which allows manually specifying SEP and Baseband for restoring


Features

  • Supports the following downgrade methods
    • Prometheus 64bit devices (generator and nonce collision mode)
    • Odysseus for 32bit devices
    • Re-restoring 32bit devices to iOS 9 with @alitek123's no-nonce method
  • Allows restoring any nonmatching signed iOS/Sep/Baseband

Help

(might become outdated):

Usage: futurerestore [OPTIONS] /path/to/ipsw

Options:

  -t, --apticket PATH		APTicket used for restoring
  -u, --update			Update instead of erase install (requires appropriate APTicket)
  -w, --wait			Keep rebooting until nonce matches APTicket (nonce collision, unreliable)
  -d, --debug			Verbose debug output (useful for error logs)
      --latest-sep		Use latest signed sep instead of manually specifying one (may cause bad restore)
      --latest-baseband		Use latest signed baseband instead of manually specifying one (may cause bad restore)
      --no-baseband		Skip checks and don't flash baseband
                   		WARNING: only use this for device without a baseband (eg. iPod or some wifi only iPads)

To extract baseband/SEP automatically from IPSW:

  -i, --source-ipsw PATH	Source IPSW to extract baseband/SEP from

To manually specify baseband/SEP:

  -b, --baseband PATH		Baseband to be flashed
  -p, --baseband-manifest PATH	BuildManifest for requesting baseband ticket
  -s, --sep PATH		SEP to be flashed
  -m, --sep-manifest PATH	BuildManifest for requesting sep ticket

Dependencies

  • Runtime

    • On macOS and Windows, futurerestore requires no runtime dependencies, the following are only for compiling.
    • On Linux, usbmuxd is required at runtime.
  • External Libs

    Make sure these are installed
    • libzip
    • libcurl
    • openssl (or CommonCrypto on OSX)
    • libplist
  • Submodules

    Make sure these projects compile on your system (install their dependencies)

0) What futurerestore can do

Downgrade/Upgrade/Re-restore same iOS. Whenever you read "downgrade" nowadays it means you can also upgrade and re-restore if you're on the same iOS. Basically this allows restoring an iOS and the installed iOS doesn't matter.


1) Prometheus (64bit device) - generator method

Requirements

  • Jailbreak
  • SHSH2 files with a generator
  • nonceEnabler patch enabled

Info

You can downgrade if the destination iOS is compatible with the latest signed SEP and if you have shsh2 files with a generator for that iOS.

How to use

  1. Device must be jailbroken and nonceEnabler patch must be active
  2. Open shsh file and look up the generator
  • Looks like this: <key>generator</key><string>0xde3318d224cf14a1</string>
  1. Write the generator to device's NVRAM
  • SSH into the device and run nvram com.apple.System.boot-nonce=0xde3318d224cf14a1 to set the generator 0xde3318d224cf14a1
  • verify with nvram -p
  1. Connect your device in normal mode to computer
  2. On the computer run futurerestore -t ticket.shsh --latest-baseband --latest-sep ios.ipsw

Youtube

Prometheus Prometheus

Prometheus NonceEnabler

Recommended method to active nonceEnabler patch

  1. Get nvpatch https://github.com/Siguza/ios-kern-utils/releases/
  2. Run on the device nvpatch com.apple.System.boot-nonce

Activate tfp0 if jailbreak doesn't allow it

Method 1 (if jailbroken on 9.3.x)

Method 2


2) Prometheus (64bit device) - nonce collision method

Requirements

  • iPhone5s or iPad Air on iOS 9.1 - 10.2
  • No Jailbreak required
  • SHSH files with customly chosen APNonce
  • The shsh file needs to have one of the nonces, which the device generates a lot

Info

You can downgrade if the destination iOS is compatible with the latest signed SEP. You also need to have special shsh files. If you don't know what this is, you probably can NOT use this method!

How to use

  1. Connect your device in normal mode or recovery mode
  2. On the computer run futurerestore -w -t ticket.shsh --latest-baseband --latest-sep ios.ipsw
  • If you have saved multiple tickets with different nonces you can specify more than one to speed up the process: futurerestore -w -t t1.shsh -t t2.shsh -t t3.shsh -t t4.shsh --latest-baseband --latest-sep ios.ipsw

3) Odysseus (32bit devices)

Requirements

  • futurerestore compiled with libipatcher (odysseus support)
  • Jailbreak or bootrom exploit (limera1n)
  • Firmware keys for the device/destination iOS must be public (check ipsw.me)
  • SHSH files for the destination iOS (OTA blobs work too!)

Info

If you have a jailbroken 32bit device you can downgrade to any iOS you have blobs for. You can still get OTA blobs for iOS 6.1.3 and 8.4.1 for some devices and use those.

How to use

  1. Get device into kDFU/pwnDFU
  • Pre-iPhone4s (limera1n devices):
    • Enter pwndfu mode with redsn0w or any other tool
  • iPhone4s and later:
    • Jailbreak required!
    • Enter kDFU mode with kDFU app (cydia: repo.tihmstar.net) or by loading a pwniBSS from any existing odysseus bundle.
  1. Connect your device to computer in kDFU mode (or pwnDFU mode)
  2. On the computer run futurerestore --use-pwndfu -t ticket.shsh --latest-baseband ios.ipsw

Youtube

Odysseus Futurerestore + Libipatcher

Odysseus kDFU App

Odysseus Enter kDFU Mode (watch up to the point where the screen goes black)

You can use any odysseus bundle for this

4) iOS 9 Re-restore bug (found by @alitek123) (32bit devices):

Requirements

  • No Jailbreak required
  • SHSH files without a nonce (noNonce APTickets)

Info

If you have shsh files for iOS9 which do not contain a nonce, you can restore to that firmware.

How to use

  1. Connect your device in DFU mode
  2. On the computer run futurerestore -t ticket.shsh --latest-baseband ios9.ipsw

About

iOS upgrade and downgrade tool utilizing SHSH blobs (unofficial fork)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 93.3%
  • M4 3.0%
  • Makefile 1.6%
  • Shell 1.4%
  • C 0.7%