Update readme to include names of *all* devices supported

- Also have easier to read descriptions, and an example screenshot of the tool
2026-10-21 01:37:02 +02:00 · 2024-04-06 05:39:33 -07:00
1 parent 3a2c372325
commit 3a08a27dcd
@@ -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
+<!--- Mobile --->
+
+| 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).
+
+<!--- T2 --->
+<details>
+<summary>Apple T2 Device Support (click to expand)</summary>
+
+| 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) |
+
+
+
+</details>
+
+
+## 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.
-		<details><summary>Technical explanation</summary>The 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.</details>
-
- 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