A GUI wrapper for a hacked up wrapper for a full reimplementation of the restore of a firmware to a device, which allows manually specifying SEP and Baseband for restoring, written in Java with Swing.
More simply, A modern GUI for FutureRestore, with added features to make the process easier.
Download from releases. No Java installation required (it's bundled).
- Mac: Right click the Mac app and click "Open" to open.
- Windows: Double click the Windows MSI to install the App. Launch it from the Start Menu or the Desktop shortcut.
- Linux (64 bit, amd64/x86_64):
- On Debian based Linux systems, such as Ubuntu and Mint, double click the .deb file to install it. Launch it from your application library.
- On other Linux systems, download the Linux-Universal build, and run the
Run FutureRestore GUI.sh
script in terminal to launch the GUI.
- Mac:
brew install futurerestore-gui
- Windows:
winget install futurerestore-gui
- Debian Linux:
u="https://coocoofroggy.github.io/CoocooFroggy-PPA/" && curl -s --compressed $u"KEY.gpg" | sudo apt-key add - && sudo curl -s --compressed -o /etc/apt/sources.list.d/coocoofroggyppa.list $u"coocoofroggyppa.list" && sudo apt update && sudo apt install futurerestore-gui
- Fancy, user-friendly interface for selecting files for FutureRestore. No more huge commands such as:
/Users/CoocooFroggy/Downloads/futurerestore -d -t /Users/CoocooFroggy/Downloads/353561670934855681_iPhone69\,4_d200ap_18.2-31D37_27325c8258be46e69d9ee57fa9a8fbc28b873df434e5e702a8b27999551138ae.shsh2 --latest-sep --latest-baseband /Users/CoocooFroggy/Downloads/iPhone69\,4\,iPhone20\,0_18.2_31D37_Restore.ipsw
- Only select BuildManifest once for both SEP and BB.
- Ensures you don't select incorrect files: The program will ensure you have a working FutureRestore build. You can only select .iPSW files for target firmware, .BBFW files for baseband, etc.
- Download FutureRestore will automatically fetch the latest FutureRestore for your operating system, extract it, and select it.
- Exit Recovery button to run
futurerestore --exit-recovery
- Stop FutureRestore to kill the FutureRestore process. Button dynamically changes to "Stop FutureRestore (Unsafe)" while the process is running. Pop-up to confirm killing the process if it's currently running.
- Automatically launch with Dark or Light mode theme (not supported on Linux).
- Error parsing such as iBEC, APTicket-APNonce mismatch, unable to place device in recovery mode. Will show a pop-up with some help and a link on where to get help.
- Automatically retry FutureRestore only once if error received is "unable to place device in recovery mode."
- Inline GUI progress bar for downloading SEP, BB, Sending Filesystem, etc.
- Automatically saves all logs to
/[Home]/FutureRestoreGUI/logs
. Never worry about accidentally closing terminal, forgetting to paste your terminal to pastebin, etc. - Current task text field to simply show what FutureRestore is doing.
- Log smart autoscroll when scrolled to the bottom.
- Optionally share logs automatically to help improve FutureRestore
- If you like terminal, you can use this to simply generate the command and copy it with a few clicks
- Automatic dark mode supported for macOS, Windows 10, and some Linux distros
- Pwndfu restore and onboard blobs (with a supported FutureRestore build)
- Share logs: Shares logs automatically to help develop FutureRestore.
- Preview command: Preview the final FutureRestore command. You can then choose to copy and/or run the command.
- GUI updates: Automatically checks for updates for this program on launch.
- FutureRestore Beta: The Download FutureRestore button will download the latest beta asset of FutureRestore.
- GUI themes: Choose between system theme, force light, or force dark theme.
- Download FutureRestore automatically through the Download FutureRestore button, or manually from m1stadev's fork.
- Select your blob (SHSH2) file.
- Select your target firmware (iPSW) file.
- Choose your desired arguments. See this table for an explanation of arguments.
- Baseband and SEP (choose 1 each):
- If the latest Baseband and/or SEP firmware is compatible with your target version, select Latest Baseband/Latest SEP.
- Otherwise, choose Manual Baseband/Manual SEP, and select your desired Baseband and SEP (BBFW and IM4P), along with a BuildManifest (.PList).
- If your device is Wi-Fi only (no cellular/calling ability), select No Baseband. If it does not have a Secure Enclave, select No SEP.
- Start FutureRestore!
- You can take your device out of recovery mode with Exit Recovery, which will set
auto-boot
to true and reboot the phone. - You may kill the FutureRestore process while it is running, but it is considered unsafe. It is strongly recommended to not press the Stop FutureRestore button while the button's text indicates that it is "unsafe," unless you know what you are doing.
Download FutureRestore using the button included in the GUI, or manually from here. Download target iPSW from iPSW.me or iPSW.dev.
For FutureRestore related issues, send a message in #support in the official FutureRestore support server.
For GUI related issues, open an issue in the GitHub issues section.
git clone https://github.com/CoocooFroggy/FutureRestore-GUI.git
Build a .jar with gradle shadowjar
. Requires Java 11 or later. Class Main
, method main
is the entry point of this program. Please do not touch Not an actual Number.
Package to a Windows .msi, Mac .app, or Linux .deb, .rpm, app-image with JPackage from Java 14 or later (continuous integration releases use Java 15).
Pull requests are welcome. For feature requests, please open an issue to discuss what improvements you would like to see.