Create & Restore 64-bit custom IPSWs
License: BSD 3-Clause "New" or "Revised" License
I'm a hobbyist Python developer that's interested in low-level iOS.
| Project | Description |
|---|---|
| PyIMG4 | A Python library/CLI tool for parsing Apple's Image4 format. |
| lykos | A Python library/CLI tool for fetching *OS firmware keys. |
| AutoTSS | A Discord bot that automatically saves SHSH blobs for all of your iOS devices. |
| apple-compress | Python bindings for Apple's libcompression. |
| dmgdec | A Python library/CLI tool for decrypting IPSW DMGs. |
I successfully created custom IPSW with script "inferius.py" that was presented in master archive of Inferius.
Next step I need is running script "restituere.py" to restore custom IPSW to my device.
But I can't find this script in master archive.
Where I can find it?
Thanks!
Probably best to cut down on the size of the repository, possibly making it easier to create a "binary" that isn't already big enough.
Already opened a PR
i am stack on futurerestore is not installed , idont know how to resolve it ..i put futurestore on same folder but nothing ..plz how to install it or copilate with img4tool as you say ..thankyou
iam using macos highsierra
./inferius -d iPhone9,1 -i 12.4 -f iPhone_4.7_P3_12.4_16G77_Restore_custom.ipsw -r
verifying version
extracting restore.plist
extracting buildmanifest.plist
[ERROR] This FutureRestore cannot be used with Inferius. Exiting...
Im sorry for asking where for this bundle. but i can't create it. im just not that handy about this stuff.
can you please create it?
Again, sorry for taking some of your time for this request.
I see iPad4,5_11.4.1_bundle in /resources/FirmwareBundles.
Can I use it to restore iPad4,4 iOS 11.4.1 with only fixing Info.json file ?
Or patch files must be unique and different anyway?
hello .
i have problem.
I can't figure out how to compile futurerestore and img4tool correctly.
I also found a compiled futurerestore specifically for inferius, but I don’t know in which folder to insert it.
I need your help.
Mac OS Catalina.
[VERBOSE] Verifying device iPhone9,1 exists...
[VERBOSE] Device iPhone9,1 exists!
[VERBOSE] Verifying iOS 12.4 exists for device iPhone9,1...
[VERBOSE] iOS 12.4 exists for device iPhone9,1!
[VERBOSE] Finding Firmware Bundle for iPhone9,1, 12.4
[VERBOSE] Firmware bundle exists at: resources/FirmwareBundles/iPhone9,1_12.4_bundle
[VERBOSE] Checking if device is A9...
[VERBOSE] Device is not A9, continuing...
Traceback (most recent call last):
File "/Users/tolikes/Desktop/Inferius-master/./inferius.py", line 194, in
if args.update:
AttributeError: 'Namespace' object has no attribute 'update'
File "./inferius.py", line 167, in
buildid = ipsw.check_buildid(firmware_bundle)
File "/Users/Light/Desktop/Inferius/resources/ipsw.py", line 304, in check_buildid
if bundle_data['files']['ramdisk'][x]['buildid']:
KeyError: 0
hello, I want to downgrade my iPhone 8 from 14.6 to 14.3, but encounter some errors.
what should I do next?
the output of inferius:
[7] Restoring...
Traceback (most recent call last):
File "./inferius", line 152, in
main()
File "./inferius", line 148, in main
restore_ipsw(api, buildmanifest, custom_ipsw, args.update, tmpdir)
File "./inferius", line 87, in restore_ipsw
restore.restore(ipsw_path, device.baseband, updating)
File "/Users/cyanide/Desktop/Inferius-master/utils/restore.py", line 40, in restore
if 'Done: restoring succeeded!' not in futurerestore.stdout:
TypeError: argument of type 'NoneType' is not iterable
the futurerestore log:
Extracting iBEC.d20.RELEASE.im4p...
Personalizing IMG4 component iBEC...
Sending iBEC (1438354 bytes)...
waiting for device to reconnect... Cleaning up...
[exception]:
what=failed to reconnect to device in recovery (iBEC) mode
code=65863697
line=1005
file=futurerestore.cpp
commit count=196:
commit sha =e6c21f160eae23f9fab240fa088b0dcffca0e6b2:
Done: restoring failed!
Preparations done! Beginning restore...
[VERBOSE] Sent iBSS
[VERBOSE] Sent iBEC
[VERBOSE] Booted iBEC
[VERBOSE] Checking if device is in pwnrecovery...
[VERBOSE] Device entered pwnrecovery successfully!
[VERBOSE] Device has cellular support, restoring with baseband.
Traceback (most recent call last):
File "/Users/tolikes/Desktop/Inferius-master/./inferius.py", line 215, in
restore_ipsw(fresh_ipsw, ipsw_path)
File "/Users/tolikes/Desktop/Inferius-master/./inferius.py", line 103, in restore_ipsw
futurerestore = restore.restore(ipsw_path, ipsw.is_cellular(device_identifier), keep_data, downgrade_10, is_verbose)
File "/Users/tolikes/Desktop/Inferius-master/resources/restore.py", line 61, in restore
if futurerestore.returncode != 0:
UnboundLocalError: local variable 'futurerestore' referenced before assignment
Please add support for iOS 9.x 8.x and 7.x
I use Inferius-develop. I
gude@gudedeMac-Pro Inferius-develop % ./inferius -d iPad4,4 -f /Users/gude/Desktop/Inferius-master/IPSW/iPad_64bit_11.4.1_15G77_Restore_custom.ipsw -r
Inferius - Create & Restore 64-bit custom IPSWs
Restoring custom IPSW
utils.errors.DependencyError: This FutureRestore build cannot be used with Inferius.
f I useInferius-master. It said
'gude@gudedeMac-Pro Inferius-master % ./inferius -d iPad4,4 -f /Users/gude/Desktop/Inferius-master/IPSW/iPad_64bit_11.4.1_15G77_Restore_custom.ipsw -r Restoring custom IPSW [1] Verifying custom IPSW... [2] Checking for device in pwned DFU... [3] Extracting bootchain... [4] Signing bootchain... [5] Sending bootchain... [6] Saving SHSH blobs... ERROR: Unable to connect to device Traceback (most recent call last): File "/Users/gude/Desktop/Inferius-master/./inferius", line 150, in <module> main() File "/Users/gude/Desktop/Inferius-master/./inferius", line 146, in main restore_ipsw(api, buildmanifest, custom_ipsw, args.update, tmpdir) File "/Users/gude/Desktop/Inferius-master/./inferius", line 84, in restore_ipsw restore.save_blobs(device.ecid, device.board, tmpdir, device.fetch_apnonce()) File "/Users/gude/Desktop/Inferius-master/utils/device.py", line 55, in fetch_apnonce irecv = subprocess.check_output(('irecovery', '-q'), universal_newlines=True) File "/usr/local/Cellar/[email protected]/3.9.12/Frameworks/Python.framework/Versions/3.9/lib/python3.9/subprocess.py", line 424, in check_output return run(*popenargs, stdout=PIPE, timeout=timeout, check=True, File "/usr/local/Cellar/[email protected]/3.9.12/Frameworks/Python.framework/Versions/3.9/lib/python3.9/subprocess.py", line 528, in run raise CalledProcessError(retcode, process.args, subprocess.CalledProcessError: Command '('irecovery', '-q')' returned non-zero exit status 255. gude@gudedeMac-Pro Inferius-master %
Making all in futurerestore
make[2]: *** No rule to make target ../external/idevicerestore/src/libidevicerestore.la', needed by futurerestore'. Stop.
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2
Put iPad in Pwned DFU with ipwndfu or pyboot. New error about SHSH and Internet connection. But internet is ok.
Preparations done! Beginning restore...
[VERBOSE] Sent iBSS
[VERBOSE] Sent iBEC
[VERBOSE] Checking if device is in pwnrecovery...
2020-12-18 16:05:30.311 system_profiler[12067:145435] SPUSBDevice: IOCreatePlugInInterfaceForService failed 0xe00002be
2020-12-18 16:05:30.320 system_profiler[12067:145435] SPUSBDevice: IOCreatePlugInInterfaceForService failed 0xe00002be
[VERBOSE] Device entered pwnrecovery successfully!
[VERBOSE] Device has cellular support, restoring with baseband.
Traceback (most recent call last):
File "./inferius.py", line 215, in
restore_ipsw(fresh_ipsw, ipsw_path)
File "./inferius.py", line 103, in restore_ipsw
futurerestore = restore.restore(ipsw_path, ipsw.is_cellular(device_identifier), keep_data, downgrade_10, is_verbose)
File "/Users/sparkerfus/Downloads/Inferius-master/resources/restore.py", line 61, in restore
if futurerestore.returncode != 0:
UnboundLocalError: local variable 'futurerestore' referenced before assignment
Attempted restore to iOS 11.3 on an iPhone7,1.
x@192-168-10-195 Inferius-master % ./bundlegen -d 'iPhone10,3' -i '14.6'
Creating Firmware Bundle for iPhone10,3, iOS 14.6
[1] Grabbing decryption keys...
[2] Patching bootchain...
[3] Patching kernel...
[4] Patching ramdisk. This may take a while, please wait...
zsh: segmentation fault ./bundlegen -d 'iPhone10,3' -i '14.6'
https://github.com/dora2-iOS/ra1npoc this is pndfu for a1584. thanks dear 
Version: 828924228b85e7906610244f24d0b17f5723c667 - 198
how can I solve this?
File "./inferius.py", line 195, in
utils.log(f'[INFO] Device boardconfig: {board_configs[firm_bundle_number]}')
TypeError: log() missing 1 required positional argument: 'is_verbose'
Is your device is connected in Pwned DFU mode with signature checks removed? [Y/N]: Y [VERBOSE] Checking if device is in pwnrecovery... [ERROR] Device did not enter recovery mode successfully! Make sure your device is in Pwned DFU mode with signature checks removed, then run this script again. Exiting...
Now, when I try to restore my custom IPSW i faced problem with putting device into Pwned DFU mode.
I can manually put it into common DFU mode, but not Pwned DFU.
Did you include instruments for putting device into Pwned DFU mode in master archive?
Should script Infernus.py calls it by itselfs?
Or I need to search and use for Pwned DFU some 3rd party tools like axi0mX/ipwndfu
I can't figure out what dependancy this is:
/opt/local/lib/libreadline.8.dylib
Any help would be appreciated
Thanks :)
i used to be able to run this on linux but now it only supports macOS, what happened to linux support? can you try to add it back?
I can’t get it to compile on my machine(neither futurerestore or img4tool)
./inferius -d iPhone10,1 -f /Users/cat/Downloads/iPhone_4.7_P3_14.8_18H17_Restore.ipsw -c -b /Users/cat/Downloads/Inferius-master/FirmwareBundles/iPhone10,1_15.4.1_19E258.bundle
Creating custom IPSW
[1] Grabbing Firmware Bundle...
Note: Using user provided Firmware Bundle.
[2] Verifying IPSW...
[3] Extracting IPSW...
[4] Patching components...
Traceback (most recent call last):
File "./inferius", line 150, in
main()
File "./inferius", line 141, in main
custom_ipsw = create_ipsw(api, buildmanifest, ipsw_path, tmpdir, bundle)
File "./inferius", line 41, in create_ipsw
bundle.apply_patches(extracted_ipsw)
File "/Users/cat/Downloads/Inferius-master/utils/bundle.py", line 22, in apply_patches
bsdiff4.file_patch_inplace(f"{ipsw}/{patch['file']}", f"{self.bundle}/{patch['patch']}")
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/bsdiff4/format.py", line 104, in file_patch_inplace
fo.write(core.patch(data, *read_patch(fi)))
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/bsdiff4/format.py", line 40, in read_patch
assert magic[:7] == MAGIC[:7]
AssertionError
cat@iMac-cat Inferius-master %
anatoliibonderenko@MacBook-Pro-de-Anatolii Inferius-master % ./inferius -d iPhone9,2 -f ./iPhone_5.5_P3_12.4.1_16G102_Restore.ipsw -c
Creating custom IPSW
[1] Grabbing Firmware Bundle...
[ERROR] A Firmware Bundle does not exist for iPhone9,2, iOS 12.4.1. Exiting.
anatoliibonderenko@MacBook-Pro-de-Anatolii Inferius-master % cd ./FirmwareBundles
anatoliibonderenko@MacBook-Pro-de-Anatolii FirmwareBundles % ls
iPhone9,2_10.1_14B72c.bundle iPhone9,2_12.4.1_16G102.bundle
anatoliibonderenko@MacBook-Pro-de-Anatolii FirmwareBundles %
./bundlegen -d iPad6,7 -i 14.0
Creating Firmware Bundle for iPad6,7, iOS 14.0
[1] Grabbing decryption keys...
[ERROR] Decryption keys for iPad6,7, iOS 14.0 are not on The iPhone Wiki. Exiting.
Creating Firmware Bundle for iPhone9,2, iOS 12.4.1
[1] Grabbing decryption keys...
[2] Patching bootchain...
[3] Patching kernel...
[4] Patching ramdisk. This may take a while, please wait...
Stuck 40 minutes +
MatthewsMacBook:Inferius matthew$ ./inferius.py -d iPhone6,2 -i 11.3 -f /Users/matthew/Downloads/iPhone_4.0_64bit_11.3_15E216_Restore.ipsw
Finding Firmware bundle for iPhone6,2, 11.3...
Extracting IPSW. This may take a while, please wait...
IPSW extracted! Verifying bootchain...
Bootchain verified! Patching bootchain...
Traceback (most recent call last):
File "./inferius.py", line 89, in
patch.patch_bootchain(firmware_bundle, ipsw_dir, firm_bundle_number)
File "/Users/matthew/Downloads/Inferius/resources/patch.py", line 21, in patch_bootchain
bsdiff4.file_patch_inplace(f'work/ipsw/{ibss[0]}', f'{firm_bundle}/{ibss[1]}')
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/bsdiff4/format.py", line 104, in file_patch_inplace
fo.write(core.patch(data, *read_patch(fi)))
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/bsdiff4/format.py", line 40, in read_patch
assert magic[:7] == MAGIC[:7]
AssertionError
MatthewsMacBook:Inferius matthew$
have installed the requirements, sorry in advance if this is something simple
input : ./bundlegen -d iPhone9,3 -i 14.5.1
output :
Creating Firmware Bundle for iPhone9,3, iOS 14.5.1
[1] Grabbing decryption keys...
[2] Patching bootchain...
[ERROR] Decrypting '/tmp/tmp8qa2dhob/Firmware/dfu/iBSS.d10.RELEASE.im4p' failed. Exiting.
anyone know how to solve this problem ?
Seposfun failed, but you no :D
It would be great if you add the possibility of deactivating SEP and downgrade tethered to any ios version (RIP passcode or Touch ID)
This probably seems like a stupid question, but how should I compile futurerestore with M1stadev's fork of img4tool? I have tried downloading the latest compiled version of futurerestore from M1stadev's Github page, and Inferius just tells me that that futurerestore cannot be used with Inferius. Any help would be greatly appreciated!
hanisa0401@hanisas-MacBook inferius % ./bundlegen -d iPhone9,4 -i 14.0
Creating Firmware Bundle for iPhone9,4, iOS 14.0
[1] Grabbing decryption keys...
[2] Patching bootchain...
[3] Patching kernel...
[ERROR] Failed to generate img4 patchfile for kernel. Exiting.
I Am Using The Rewrite Version On Inferius But I Am Using iPhone SE 1st Generation And I'm Downgrading To iOS 13.5 But Typing The Command In Terminal It Says: [ERROR] FutureRestore is not installed on your system. Exiting... Please Help Me!
hello, I compiled or installed all dependencies correctly (include your fork of img4tool), but it still says
[ERROR] This futurerestore cannot be used with Inferius. Exiting.
the out put of futurerestore:
Version: e6c21f160eae23f9fab240fa088b0dcffca0e6b2 - 196
img4tool version: 0.199-c150c278bd9316a95d215363c2f3e998dede90ed-m1sta-RELEASE
libipatcher version: 0.82-0b2f79ff0917ef9b8a92475d93d9466b23fc2322-RELEASE
Odysseus for 32-bit support: yes
Odysseus for 64-bit support: yes
I really need Inferius, what should I do next?
thx
I have entered pwned dfu mode with signature checks removed but I still get this error:
[ERROR] Device did not enter recovery mode successfully! Make sure your device is in Pwned DFU mode with signature checks removed, then run this script again.
Exiting...
[VERBOSE] Checking for required dependencies...
Finding Firmware bundle for iPhone8,4, 13.3...
Firmware bundle for iPhone8,4, 13.3 doesn't exist!
If you have provided your own firmware bundle,
please make sure it is in 'resources/FirmwareBundles'
and named iPhone8,4_13.3_bundle
Self explanatory. If I had a Mac I would do it myself but I don't have access to one, sadly.
gude@gudedeMac-Pro Inferius-develop % ./inferius -d iPad4,4 -f /Users/gude/Desktop/Inferius-master/IPSW/iPad_64bit_11.4.1_15G77_Restore_custom.ipsw -r
zsh: permission denied: ./inferius
Whenever I try to run bundlegen, I always get this error: /bundlegen -d iPhone9,4 -i 11.4.1
[ERROR] 'asr64_patcher' was not found on your system. Exiting. I have downloaded asr64_patcher and put it into the root directory, but I always get this error. Any help would be appreciated.
This fortnite cheat menu does not work 0/10 i think it gave me a virus.
Hi,
Once I have downloaded the requirement files for bundlegen. Where do I place them so that bundlegen recognises them please?
Many thanks
adog9712
Is this GSX solution? someone recommended this service. I strongly recommend LANTOOLS on !G. He fixed my iPhone XR. He’s legit and fast
Hello.
i have an iphone x with ios 14.7.1
iphone 8 with ios 14.6 and iPhone 7 plus with ios 15
I am trying to downgrade the firmware to 14.7.1 but I get the error:
cat@iMac-cat Inferius-master 2 % ./inferius -d iPhone9,2 -f /Users/cat/Desktop/Inferius-master\ 2/IPSW/iPhone_5.5_P3_14.7.1_18G82_Restore_custom.ipsw -r
Restoring custom IPSW
[1] Verifying custom IPSW...
[2] Checking for device in pwned DFU...
[3] Extracting bootchain...
[4] Signing bootchain...
[5] Sending bootchain...
[6] Saving SHSH blobs...
[7] Restoring...
Traceback (most recent call last):
File "./inferius", line 158, in
main()
File "./inferius", line 154, in main
restore_ipsw(api, buildmanifest, custom_ipsw, args.update, tmpdir, blob, signing_blob)
File "./inferius", line 93, in restore_ipsw
restore.restore(ipsw_path, device.baseband, updating)
File "/Users/cat/Desktop/Inferius-master 2/utils/restore.py", line 39, in restore
if 'Done: restoring succeeded!' not in futurerestore.stdout:
TypeError: argument of type 'NoneType' is not iterable
cat@iMac-cat Inferius-master 2 %
some people while making firmwarebundle can be complex for them so for example when someone plugs in iDevice to mac, a script automatically takes info from iDevice and generates FirmwareBundle that matches the iPhone, but before the script has successfuly generated the FirmwarBundle it asks the user the iOS version they want to downgrade to (13.5) then the firmwarebundle is now generated and the downgrade process can be started. (sorry for bad grammar btw)
I prefer iOS 14.x over 15.x so this would be greatly appreciated
gude@gudedeMac-Pro Inferius-master % ./inferius -d iPad4,4 -f /Users/gude/Desktop/Inferius-master/IPSW/iPad_64bit_11.4.1_15G77_Restore_custom.ipsw -r
Restoring custom IPSW
[1] Verifying custom IPSW...
[2] Checking for device in pwned DFU...
[3] Extracting bootchain...
[4] Signing bootchain...
[5] Sending bootchain...
[6] Saving SHSH blobs...
[7] Restoring...
Traceback (most recent call last):
File "/Users/gude/Desktop/Inferius-master/./inferius", line 150, in
main()
File "/Users/gude/Desktop/Inferius-master/./inferius", line 146, in main
restore_ipsw(api, buildmanifest, custom_ipsw, args.update, tmpdir)
File "/Users/gude/Desktop/Inferius-master/./inferius", line 87, in restore_ipsw
restore.restore(ipsw_path, device.baseband, updating)
File "/Users/gude/Desktop/Inferius-master/utils/restore.py", line 40, in restore
if 'Done: restoring succeeded!' not in futurerestore.stdout:
TypeError: argument of type 'NoneType' is not iterable
arinc9@Arncs-iMac Inferius % python3 inferius.py -d 'iPhone10,6' -i '13.5' -f 'iPhone10,3,iPhone10,6_13.5_17F75_Restore.ipsw' -v
[VERBOSE] Checking for required dependencies...
Finding Firmware bundle for iPhone10,6, 13.5...
[VERBOSE] Firmware bundle exists at: resources/FirmwareBundles/iPhone10,6_13.5_bundle
[VERBOSE] Checking if device is A9...
[VERBOSE] Device is not A9, continuing...
[VERBOSE] iPhone10,3,iPhone10,6_13.5_17F75_Restore.ipsw is a zip archive!
Extracting IPSW at iPhone10,3,iPhone10,6_13.5_17F75_Restore.ipsw. This may take a while, please wait...
[VERBOSE] IPSW extracted to: work/ipsw
IPSW extracted! Verifying bootchain...
[VERBOSE] Firmware/dfu/iBSS.d22.RELEASE.im4p verified!
Traceback (most recent call last):
File "./inferius.py", line 82, in <module>
ipsw.verify_bootchain(firmware_bundle, firm_bundle_number, 'yes')
File "/Volumes/2TB/Inferius/resources/ipsw.py", line 86, in verify_bootchain
with open(f'work/ipsw/{bootchain_path[x]}', 'rb') as f:
FileNotFoundError: [Errno 2] No such file or directory: 'work/ipsw/Firmware/dfu/iBEC.iphone6.RELEASE.im4p'
Sounds like an API error from ipsw.me
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.