Legacy-iOS-Kit

mirror of https://github.com/LukeZGD/Legacy-iOS-Kit.git synced 2025-07-17 15:37:27 +02:00

Table of Contents

The procedure will be depending on your usage, operating system, and iOS device. Make sure that your setup is supported by the script. See the README for details before continuing.
I (LukeZGD) will not be held responsible for any consequences or damages that may happen to your devices. Proceed at your own risk.

Initial Setup

Legacy iOS Kit needs initial setup before usage. Please select your operating system.

Linux/macOS

Download Legacy iOS Kit here and extract the zip archive.
- You may also clone the repo: git clone --filter=blob:none https://github.com/LukeZGD/Legacy-iOS-Kit
- For git clone, shallow clones (like --depth 1) are not supported. Do a blobless clone instead, as shown above.
Open a Terminal window.
(macOS only) Install Xcode Command Line Tools by running this command: xcode-select --install
Start the script: Go to where the extracted files are located, drag restore.sh to the Terminal window, and press Enter/Return.

On its first run, it will download and install dependencies. This will take some time depending on your Internet connection. When it's done, proceed to the next section.

Windows

There is no Windows version of Legacy iOS Kit. It will never be supported.
Windows users should use Legacy iOS Kit on Linux or macOS instead.
You can easily create an Ubuntu live USB with tools like Rufus. Make sure to enable Persistent Storage, or use another USB drive to store Legacy iOS Kit and its files.
Tutorial: https://ubuntu.com/tutorials/create-a-usb-stick-on-windows
- Make sure to set the Persistent partition size to enable Persistent Storage. You may set this to the maximum.
- For older systems, it is recommended to use a lightweight variant of Ubuntu like Linux Mint XFCE, Xubuntu, Lubuntu.
- For older versions of Rufus (3.22), do not use the latest Ubuntu since persistent storage will be broken. Use 22.04 (or Mint 21) instead.

Please select your usage.