deleo

By m1sta.

A Python CLI tool for downgrading i(Pad)OS devices.

Usage

Usage: deleo [OPTIONS] IPSW LATEST_IPSW

  A Python CLI tool for downgrading i(Pad)OS devices.

Options:
  --ecid INTEGER
  -v, --verbose
  --version                    Show the version and exit.
  -t, --shsh-blob FILENAME     SHSH blob for target restore.  [required]
  -u, --update                 Keep user data during restore (not recommended if downgrading).
  -o, --ota-manifest FILENAME  OTA build manifest for latest IPSW.
  --help                       Show this message and exit.

Requirements

• Python 3.8 or higher
• Valid SHSH blobs
• A Linux or macOS system
  • Windows support will be coming in the future
• usbmuxd on Linux systems

Notes

• deleo only supports 64-bit devices.
• In most cases, you can only restore using a signed 15.x or below IPSW as latest.
  • More info on that here.
• In place of an actual IPSW file in the IPSW or LATEST_IPSW arguments, you can pass a URL to an IPSW instead.
  • This is not recommended for the IPSW argument, as downloading the RootFS dmg directly from the ZIP will take quite a while...
• Ensure that whatever version you are restoring to is compatible with the SEP version in the latest IPSW.
  • You can find a spreadsheet that will show you what iOS versions are compatible with the latest SEP version here.
• On Linux systems that utilize udev, you may need to install proper udev rules to have proper access to connected *OS devices
  • Typically, you only need to install libirecovery from your distribution's package manager.
  • Alternatively, you can download a rules file provided here, and place it in /etc/udev/rules.d
  • Once the rules file is installed, reboot to ensure that the rules file is detected properly.

Installation

• Install from PyPI:
  • python3 -m pip install deleo
• Local installation:
  • ./install.sh
  • Requires Poetry

Support

For any questions/issues you have, open an issue.