Updated How to Use (markdown)

LukeeGD 2021-11-07 10:34:52 +08:00
parent a633f17fa2
commit 58e10f9920

@ -1,16 +1,12 @@
# Section 0.1 - Requirements # Section 0.1 - Requirements
- A **supported iOS device** (listed in the README) - A **supported iOS device** (listed in the README)
- A **64-bit Linux install/live USB** or a supported **macOS/Windows** version - A **Linux install/live USB** or a supported **macOS** version
- The IPSW firmware for the version you want to downgrade to - The IPSW firmware for the version you want to downgrade to
- The script can download it for you - The script can download it for you
- The script will also provide a link to the IPSW if you want to download it manually - The script will also provide a link to the IPSW if you want to download it manually
# Section 0.2 - Things to note before you begin # Section 0.2 - Things to note before you begin
- **Windows:** - **Linux**: Your installation must be **64-bit**, and x86_64. ARM is not supported.
- **I recommend using iOS-OTA-Downgrader on Linux or macOS instead.** Windows SUCKS for anything downgrade or restore related.
- The Windows version of iOS-OTA-Downgrader will no longer be updated or supported.
- Read the ["Troubleshooting" wiki page](https://github.com/LukeZGD/iOS-OTA-Downgrader/wiki/Troubleshooting#windows) for more details about the stuff missing from the Windows version.
- **Windows/Linux**: Your installation must be **64-bit**, and x86_64. ARM is not supported.
- **You do NOT need blobs to use this**, the script will get them for you. - **You do NOT need blobs to use this**, the script will get them for you.
- Some of the sections and steps will be separated depending on your platform and device. - Some of the sections and steps will be separated depending on your platform and device.
- The restore will ERASE ALL DATA on your iOS device. Backup your data before proceeding. - The restore will ERASE ALL DATA on your iOS device. Backup your data before proceeding.
@ -18,22 +14,13 @@
# Section 1.1 - Setup for PC/Mac # Section 1.1 - Setup for PC/Mac
## macOS/Linux
1. [Download iOS-OTA-Downgrader](https://api.github.com/repos/LukeZGD/iOS-OTA-Downgrader/zipball) and extract the zip archive. 1. [Download iOS-OTA-Downgrader](https://api.github.com/repos/LukeZGD/iOS-OTA-Downgrader/zipball) and extract the zip archive.
- You may also clone the repo: `git clone --depth 1 git://github.com/LukeZGD/iOS-OTA-Downgrader.git` - You may also clone the repo: `git clone --depth 1 git://github.com/LukeZGD/iOS-OTA-Downgrader.git`
1. Open a Terminal window. 1. Open a Terminal window.
- For macOS, [here's how](https://support.apple.com/guide/terminal/apd5265185d-f365-44cb-8b09-71a064a42125/mac) - *macOS:** [Here's how (Open or quit Terminal on Mac)](https://support.apple.com/guide/terminal/apd5265185d-f365-44cb-8b09-71a064a42125/mac)
1. Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return. 1. Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return.
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. 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
1. Install [iTunes](https://support.apple.com/kb/DL2065?viewlocale=en_US&locale=en_US), version 12.10.11 or newer. Make sure to not install the Microsoft Store version.
1. Install [MSYS2](https://www.msys2.org/#installation), follow steps 1 to 4 only. In step 4, untick "Run MSYS2 64-bit now" before clicking Finish.
1. [Download iOS-OTA-Downgrader](https://github.com/LukeZGD/iOS-OTA-Downgrader/archive/refs/heads/windows.zip) and extract the zip archive.
1. Go to where the extracted files are located, and run `restore.cmd`
- It may only show up as `restore`. If this is the case, run the one with the gears icon. I recommend to [make Windows show file extensions](https://www.howtogeek.com/205086/beginner-how-to-make-windows-show-file-extensions/) to avoid confusion.
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.
# Section 1.2 - Setup for iOS device # Section 1.2 - Setup for iOS device
## 32-bit devices ## 32-bit devices
@ -54,20 +41,15 @@
## 32-bit devices ## 32-bit devices
1. Connect your iOS device to your PC/Mac. Make sure to also trust the computer by tapping "Trust" at the pop-up. 1. Connect your iOS device to your PC/Mac. Make sure to also trust the computer by tapping "Trust" at the pop-up.
- **Windows/macOS**: Double-check if the device is being detected by iTunes/Finder. - **macOS**: Double-check if the device is being detected by iTunes/Finder.
1. Run the script. 1. Run the script. Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return.
- **Windows**: Go to where the extracted files are located, and run `restore.cmd` (the one with the gears icon)
- **macOS/Linux**: Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return.
1. When the main menu shows up, type '1' and press Enter/Return to select Downgrade Device. 1. When the main menu shows up, type '1' and press Enter/Return to select Downgrade Device.
1. Select your target version and options, and follow the instructions that the script will give you. 1. Select your target version and options, and follow the instructions that the script will give you.
1. After the restore process, your device will be successfully in your selected target version. 1. After the restore process, your device will be successfully in your selected target version.
- **Windows**: The restore process may give out an error on your first try. If this happens, follow the steps in the ["Troubleshooting" wiki page](https://github.com/LukeZGD/iOS-OTA-Downgrader/wiki/Troubleshooting#windows)
## A7 devices ## A7 devices
1. Connect your iOS device to your PC/Mac. 1. Connect your iOS device to your PC/Mac.
1. Run the script. 1. Run the script. Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return.
- **Windows**: Take note of the limited support on Windows before proceeding. More details in the ["Troubleshooting" wiki page](https://github.com/LukeZGD/iOS-OTA-Downgrader/wiki/Troubleshooting#windows)
- **macOS/Linux**: Go to where the extracted files are located, drag `restore.sh` to the Terminal window, and press Enter/Return.
1. When the main menu shows up, type '1' and press Enter/Return to select Downgrade Device. 1. When the main menu shows up, type '1' and press Enter/Return to select Downgrade Device.
1. Let the script put the device to recovery mode, and follow the steps to enter DFU mode. 1. Let the script put the device to recovery mode, and follow the steps to enter DFU mode.
1. When in DFU mode, wait for the script will put the device to pwnDFU mode. 1. When in DFU mode, wait for the script will put the device to pwnDFU mode.