diff --git a/README.md b/README.md index ec5850c..78cf7ac 100644 --- a/README.md +++ b/README.md @@ -4,33 +4,84 @@ [![GitHub License](https://img.shields.io/github/license/palera1n/palera1n?color=%23C96FAD)](https://github.com/palera1n/palera1n/blob/main/LICENSE) -This is the official repo for the palera1n jailbreak, a jailbreak for A8 through A11, T2 devices, on iOS/iPadOS/tvOS 15.0, bridgeOS 6.0 and higher. +Jailbreak for A8 through A11, T2 devices, on iOS/iPadOS/tvOS 15.0, bridgeOS 6.0 and higher. -## Warnings -We are **NOT** responsible for any data loss, or the result of a device being bricked. The user of this program accepts responsibility should something happen to their device. While nothing should happen, jailbreaking has risks in itself. + + + +| ![Screenshot of macOS Terminal.app](assets/image-1.png) | +|:--: | +| A screenshot of palera1n being used in a Terminal | + +## Device Support + + +| iPhone(s) | iPad(s) | iPod(s) | Apple TV(s) | +|- |- |- |- | +| iPhone 6s | iPad mini 4 | iPod Touch (7th generation) | Apple TV HD | +| iPhone 6s Plus | iPad (5th generation) | | Apple TV 4K (1st generation) | +| iPhone SE (2016) | iPad (6th generation) | | | +| iPhone 7 | iPad (7th generation) | | | +| iPhone 7 Plus | iPad Pro (9.7") | | | +| iPhone 8 | iPad Pro (12.9") (1st generation) | | | +| iPhone 8 Plus | iPad Pro (10.5") | | | +| iPhone X | iPad Pro (12.9") (2nd generation) | | | + +> Note that on `A11` (iPhone X, 8, 8 Plus), **you must disable your passcode while in the jailbroken state** (on iOS 16, you need to **reset your device** before proceeding with palera1n). + + +
+Apple T2 Device Support (click to expand) + +| Apple T2 | +|- | +| Apple T2 iMac20,1 | +| Apple T2 iMac20,2 | +| | +| Apple T2 MacBookAir8,1 | +| Apple T2 MacBookAir8,2 | +| Apple T2 MacBookAir9,1 | +| | +| Apple T2 MacBookPro15,1 | +| Apple T2 MacBookPro15,2 | +| Apple T2 MacBookPro15,3 | +| Apple T2 MacBookPro15,4 | +| Apple T2 MacBookPro16,1 | +| Apple T2 MacBookPro16,2 | +| Apple T2 MacBookPro16,3 | +| Apple T2 MacBookPro16,4 | +| | +| Apple T2 iMacPro1,1 | +| Apple T2 Macmini8,1 | +| Apple T2 MacPro7,1 | +| | +| iBridge2,11 (Unknown Mac) | +| iBridge2,13 (Unknown Mac) | + + + +
+ + +## Computer Requirements +1. **USB-A** cables are recommended to use, USB-C to may have issues with palera1n and getting into DFU mode. +> Due to USB-C cables having different accessory IDs, your device may not be able to be recognized when using USB-C due to not being able to assert to its USB voltage pin. + +2. **Linux or macOS computer** +> AMD CPUs (not AMD Mobile) have an issue where it causes them to have a very low success rate with checkm8 exploit. It is not recommended that you use them with palera1n. + +> USB-C port on Apple Silicon Macs *may* require manual unplugging and replugging of the lightning cable after checkm8 exploit. This problem may be solved by connecting via USB hub, though extensions can vary. + +## Installing +Visit https://palera.in + +## Disclaimers +We are **NOT** responsible for any data loss, or the result of a device being bricked. When using palera1n, the user should accept responsibility if anything happens to their device during the process. - If your device is stuck in recovery, please run futurerestore `--exit-recovery`, or use `irecovery -n`. - - If you're unable to get out of recovery via these methods please restore with iTunes or Finder. - -- palera1n will never work in VirtualBox, VMware or any virtual machine that doesn't support PCI passthrough. - -## Requirements -- A checkm8 vulnerable iOS device on iOS 15+ (`A8` - `A11`) - - On `A11`, **you must disable your passcode while in the jailbroken state** (on iOS 16, you need to **reset your device** before proceeding with palera1n). - -- **USB-A** cables are recommended to use, USB-C may have issues with palera1n and getting into DFU mode. -
Technical explanationThe BootROM will only enter DFU if it detects USB voltage, which boils down to checking whether a certain pin is asserted from the Tristar chip. The Tristar does this based on the cable's accessory ID, and apparently USB-A and USB-C cables have different accessory IDs, and the one of the USB-C cables makes the Tristar not assert the USB voltage pin.
- -- A Linux or macOS computer - - AMD CPUs (not AMD Mobile) have an issue [with (likely) their USB controllers] that causes them to have a very low success rate with checkm8. It is not recommended that you use them with palera1n. - - If your device does not successfully jailbreak, try a computer with an Intel or other CPU - -- Apple Silicon Macs with USB-C - - USB-C port on Apple Silicon Macs may require manual unplugging and replugging of the lightning cable after checkm8 exploit. - - This problem may be solved by connecting via USB hub, though extensions can vary. +- palera1n **will not work** in VirtualBox, VMware or any virtual machine that doesn't support PCI passthrough. ## Troubleshooting - Make sure you're following the guides provided [here](https://palera.in), also when asking for support make sure you provide full details on your device, such as: - iPhone/iPad/iPod - iOS Version diff --git a/assets/image-1.png b/assets/image-1.png new file mode 100644 index 0000000..2920da8 Binary files /dev/null and b/assets/image-1.png differ