diff --git a/README.md b/README.md index 70af8ca..64afbb2 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,52 @@ -# This is a work in progress. +

+ palera1n logo +

palera1n

+

+

An iOS 15.0-15.3.1 work-in-progress, tethered checkm8 jailbreak.

+

+ Change Log + • + Discord + • + Twitter +

-Read this throughly, feel free to ask questions, know the risks. If you want to ask questions, either: +# How does it work? +It boots the device with AMFI patches. On first run, it'll boot a ramdisk which dumps your onboard blob, and installs Sileo and Substitute. +# Issues +### Linux +- Linux has some weird usbmuxd issues. We have tried our best to fix them, but there still are issues. We highly recommend to compile and install usbmuxd2. +- Stop making issues about Linux not being able to connect, we are aware. This includes being stuck on waiting for ramdisk to finish booting. + +### Warning +- We are **NOT** responsible for any data loss. The user of this program accepts responsibility should something happen to their device. While nothing should happen, jailbreaking has risks in itself. **If your device is stuck in recovery, please run one of the following:** + - futurerestore --exit-recovery + - irecovery -n +- Using this on iOS 16 has a higher chance of bootlooping you. + +### A10 and A11 devices +- On A10 and A11, **you must disable your passcode while in the jailbroken state**. + - On A10, this can be fixed in the future by implementing blackbird. + - On A11, we don't have a SEP exploit yet. + +# Prerequisites +#### Warning: You must install the Tips app from the App Store before running palera1n. +- A checkm8 vulnerable iOS device on iOS 15 (A8X-A11) + - The device must be on iOS 15.0-15.3.1 + - Currently, the best is iOS 15.1. + - iOS 15.0-15.0.2 and 15.2-15.3.1 have **App Store app launching issues**. +- Linux or macOS computer + - Python 3 must be installed. + +# How to use? +1. Clone this repo with `git clone -b tweaks --recursive https://github.com/palera1n/palera1n && cd palera1n` +2. Run `./palera1n.sh --tweaks ` + - [A10 and A11] Before running, **you must disable your passcode**. + - Put your device in DFU mode before running. +3. Follow the steps on your screen. + +# Reports 1. Ask in the r/jailbreak Discord #palera1n channel 2. Ask in the [palera1n Discord](https://discord.gg/4S3yUMxuQH) 3. Open a GitHub issue @@ -15,40 +60,6 @@ Please, please, please, provide necessary info: **DO NOT** harass tweak devs if tweaks don't work. Refer to [here](https://github.com/itsnebulalol/ios15-tweaks) for compatiblity. -# palera1n - -iOS 15.0-15.3.1 **work in progress, tethered** checkm8 "jailbreak" (TWEAKS BRANCH) - -# What does this do? - -It boots the device with AMFI patches. On first run, it'll boot a ramdisk which dumps your onboard blob, and installs Sileo and Substitute. - -**WARNING 1**: I am NOT responsible for any data loss. The user of this program accepts responsibility should something happen to their device. While nothing should happen, jailbreaking has risks in itself. If your device is stuck in recovery, please run `futurerestore --exit-recovery`, or use `irecovery -n`. Using this on iOS 16 has a higher chance of bootlooping you. - -On A10 and A11, you **must disable your passcode while in the jailbroken state**. On A10, this can be fixed in the future by implementing blackbird. On A11, we don't have a SEP exploit yet. - -# Linux issues -Linux has some weird usbmuxd issues. We have tried our best to fix them, but there stil are issues. We highly recommend to compile and install [usbmuxd2](https://github.com/tihmstar/usbmuxd2). - -Stop making issues about Linux not being able to connect, we are aware. This includes being stuck on waiting for ramdisk to finish booting. - -# Prerequisites -1. checkm8 vulnerable iOS device on iOS 15 (A8X-A11) - - You must install the Tips app from the App Store before running the script -2. Linux or macOS computer - - Python 3 is required -3. iOS 15.0-15.3.1 - - 15.1 is the best to be on as of now. 15.0-15.0.2 and 15.2-15.3.1 have App Store app launching issues -4. A brain - - Remember, this is mainly for developers. - -# How to use -1. Clone this repo with `git clone -b tweaks --recursive https://github.com/palera1n/palera1n && cd palera1n` -2. Run `./palera1n.sh --tweaks ` - - \[A10+\] Before running, you **must** disable your passcode - - Put your device in DFU Mode before running. -3. Follow the steps - # Repos All repos work with the tweaks branch because it uses normal Procursus and not rootless.