Skip to content

How to Use

LukeeGD edited this page Jun 22, 2024 · 114 revisions
  • 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
  1. Download Legacy iOS Kit here and extract the zip archive.
    • You may also clone the repo: git clone https://github.com/LukeZGD/Legacy-iOS-Kit
  2. Open a Terminal window.
  3. Start the script: Go to where the extracted files are located, drag restore.sh to the Terminal window, and press Enter/Return.

image

  1. 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.
macOS
  1. Download Legacy iOS Kit here and extract the zip archive.
    • You may also clone the repo: git clone https://github.com/LukeZGD/Legacy-iOS-Kit
  2. Open a Terminal window.
  3. Install bash, curl, and libusb from Homebrew or MacPorts.
    • Homebrew: brew install bash curl libusb
    • MacPorts: sudo port install bash curl libusb
    • For older macOS versions (< 11.0), this step is required. Also use MacPorts, not Homebrew.
    • For OS X 10.11, also install cocoadialog: sudo port install cocoadialog
    • For macOS 10.15 and newer, this step is mostly optional, but still recommended to do.
    • After the installation, exit the current Terminal window and open another one.
  4. Start the script: Go to where the extracted files are located, drag restore.sh to the Terminal window, and press Enter/Return.

image

  1. 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
  • 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.
  • Files for Windows have been removed from the repo. The final version is available here. It will no longer be updated, tested, or fixed.
  1. Install iTunes 12.6.5 or older.
    • Make sure to not install the Microsoft Store version of iTunes.
    • You may also use iTunes 12.4.3 instead
    • Make sure to install iTunes in the default location of the C: drive.
  2. Install MSYS2, follow steps 1 to 4 only. In step 4, untick "Run MSYS2 now" before clicking Finish.
    • Make sure to install MSYS2 in the default location of the C: drive.
  3. Download Legacy iOS Kit and extract the zip archive.
  4. Start the script: Run restore.cmd.
  5. 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.

Usage

Please select your usage.

More info about the options