Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/m1stadev/Inferius

Create & Restore 64-bit custom IPSWs
https://github.com/m1stadev/Inferius

Last synced: about 2 months ago
JSON representation

Create & Restore 64-bit custom IPSWs

Host: GitHub
URL: https://github.com/m1stadev/Inferius
Owner: m1stadev
License: bsd-3-clause
Archived: true
Created: 2020-08-19T01:16:17.000Z (about 4 years ago)
Default Branch: master
Last Pushed: 2022-06-07T17:08:05.000Z (over 2 years ago)
Last Synced: 2024-06-10T04:34:06.835Z (4 months ago)
Language: Python
Homepage:
Size: 192 KB
Stars: 261
Watchers: 17
Forks: 32
Open Issues: 19
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Inferius

[![License](https://img.shields.io/github/license/m1stadev/Inferius)](https://github.com/m1stadev/Inferius)

[![Stars](https://img.shields.io/github/stars/m1stadev/Inferius)]((https://github.com/m1stadev/Inferius))

Inferius is an [xpwn](https://github.com/m1stadev/xpwn)-like tool to create & restore custom IPSWs to 64-bit devices.

Its current purpose is to downgrade devices (vulnerable to [checkm8](https://github.com/axi0mX/ipwndfu)) to previous iOS versions. However, there are other possible uses for this tool as well.

## Notes and Caveats

Before using Inferius, keep in mind that

- **No one but YOU** is fully responsible for any data loss or damage caused to your device

- Downgrades are currently limited to versions compatible with the latest signed SEP version.

- Due to the downgrades being tethered, after restoring a custom IPSW you must patch the bootchain & send it to your device over pwned DFU manually to boot, as described [here](https://dualbootfun.github.io/), or use one of these tools to automate the process for you:

    - [Ramiel](https://ramiel.app/)

    - [checkra1n](https://checkra.in)

    - [PyBoot](https://github.com/MatthewPierson/PyBoot)

    - [ra1nsn0w](https://github.com/tihmstar/ra1nsn0w)

By default, firmware bundles are automatically downloaded from an [external repo](https://github.com/m1stadev/inferius-ext/tree/master/bundles). However, if there isn't a firmware bundle for the device+iOS version combo you're attempting to downgrade to, you'll need to create your own using [bundlegen](https://github.com/m1stadev/Inferius#inferius-bundle-generator).

[Pull requests](https://github.com/m1stadev/inferius-ext/compare) for new firmware bundles are welcome, as long as the firmware bundle you want to add can create a usable IPSW for the targeted version.

## Usage

```py

./inferius -d 'Identifier' -f 'IPSW' [-c/-r] [-b 'BUNDLE']

```

| Option (short)  | Option (long)         | Description                              |

|-----------------|-----------------------|------------------------------------------|

| `-d IDENTIFIER` | `--device IDENTIFIER` | Device identifier                        |

| `-f IPSW`       | `--ipsw IPSW`         | Path to IPSW                             |

| `-c`            | `--create`            | Create custom IPSW                       |

| `-r`            | `--restore`           | Restore custom IPSW                      |

| `-b`            | `--bundle BUNDLE`     | (Optional) Path to local Firmware Bundle |

| `-u`            | `--update`            | Keep data while restoring custom IPSW    |

## Requirements

- A computer running macOS or Linux

- At least **10gbs** of free space on your computer

- An Internet connection

- A 64-bit device (vulnerable to [checkm8](https://github.com/axi0mX/ipwndfu))

- A firmware bundle for your device & the iOS version to be downgraded to

    - If there isn't a firmware bundle for your device + iOS version combo, look at [bundlegen](https://github.com/m1stadev/Inferius#inferius-bundle-generator)

- [libusb](https://libusb.info/)

- [futurerestore](https://github.com/m1stadev/futurerestore)

    - futurerestore must be compiled with [my fork of img4tool](https://github.com/m1stadev/img4tool), or else it can't be used with Inferius.

- [libirecovery](https://github.com/libimobiledevice/libirecovery)

- [tsschecker](https://github.com/1Conan/tsschecker)

- Python dependencies:

    - `pip3 install -r requirements.txt`

## To-Do

- Implement iOS 10 downgrades for A7 devices.

- Update bundle documentation

# Inferius Bundle Generator

## Usage

```py

./bundlegen -d 'Identifier' -i 'iOS Version'

```

| Option (short)  | Option (long)         | Description       |

|-----------------|-----------------------|-------------------|

| `-d IDENTIFIER` | `--device IDENTIFIER` | Device identifier |

| `-i VERSION`    | `--version VERSION`   | iOS version       |

## Requirements

- A computer running macOS

- At least **250mbs** of free space on your computer

- An Internet connection

- [asr64_patcher](https://github.com/exploit3dguy/asr64_patcher)

    - A compiled binary can be found [here](https://github.com/exploit3dguy/asr64_patcher/releases)

- [img4lib](https://github.com/xerub/img4lib)

    - A compiled binary can be found [here](https://github.com/xerub/img4lib/releases)

- [kairos](https://github.com/dayt0n/kairos)

    - A compiled binary can be found [here](https://github.com/dayt0n/kairos/releases)

- [Kernel64Patcher](https://github.com/Ralph0045/Kernel64Patcher)

- [Link Identity Editor](https://github.com/sbingner/ldid)

    - A compiled binary can be found [here](https://github.com/sbingner/ldid/releases)

- Python dependencies:

    - `pip3 install -r requirements.txt`

## Special thanks

- [exploit3d](https://twitter.com/exploit3dguy) for [asr64_patcher](https://github.com/exploit3dguy/asr64_patcher)

- [NotHereForTheDong](https://github.com/NotHereForTheDong) for creating many Firmware Bundles and beta testing

- [tale](https://twitter.com/aarnavtale), [Chibibowa](https://twitter.com/Chibibowa), and [Moses](https://twitter.com/MosesBuckwalter) for beta testing

Finally, if you need help or have any questions about Inferius, join my [Discord server](https://m1sta.xyz/discord).