refactor: libciderra1n support (#764)

* refactor

refactor: remove wdi

refactor: move openra1n to its own library

refactor: move everything standalone file to src root

* submodule

* okay these shouldnt of been included

* remove

* readd

* fix openra1n libusb

* liteusb for ra1ncovery

* fix action

* token

* whatever lwra bw apwxidix

* I knew this was gonna happen

* fix mac build

* what if this doesnt work

* okay bro

* lzma resources

* rename

* use idevice++, fix multiple devices, enter recovery

* whatever

* fix

* --force-enable-ssv

* improve exploit stuff, mirror tui logic to gui

also cooool logging for libopenra1n

* fix idevice windows build

* lets not be fancy

* new idevice patch

* easier to read

* lets hope this action works!

* remove useless ifs

* not required for non tui

* PLEASE COMPILE

* gsed lmao

* this might work idk

* whatever bro

* ah

* amd fix

* fix ts

* fix

* licensing

* update paleinfo

* LETS NOT do that

* forgot a file
This commit is contained in:
c authored and GitHub committed 2026-07-21 20:22:02 -07:00
1 parent f15011828b
commit 0cf2c6492f
128 files changed
+12054 -3114

No files matched your search

+55 -28
View File
@@ -16,8 +16,7 @@ Jailbreak for A8 through A11, T2 devices, on iOS/iPadOS/tvOS 15.0, bridgeOS 5.0
| iPhone 8 | iPad Pro (12.9") (1st generation) | | |
| iPhone 8 Plus | iPad Pro (10.5") | | |
| iPhone X | iPad Pro (12.9") (2nd generation) | | |
| | iPad Air 2 | | |
| | iPad Air 2 | | |
> 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).
@@ -54,28 +53,47 @@ Jailbreak for A8 through A11, T2 devices, on iOS/iPadOS/tvOS 15.0, bridgeOS 5.0
</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
## Building
Building is going to be a bit convoluted for each platform, each having their own unique specifications, but the best reference for building should be looking at how [GitHub actions](./.github/workflows/build.yml) does it.
```sh
# Supported params:
# GUI support (0 default):
# WITH_GUI=1
# TUI support (0 default):
# WITH_TUI=1
# Default ramdisk (1 default):
# WITH_RAMDISK=1
# Default overlay (1 default):
# WITH_BINPACK=1
# Compile statically (0 default):
# WITH_STATIC=0
# Compile using libciderra1n as backend (0 default):
# WITH_CIDERRAIN=0
# Debug or release build ("Debug" default):
# BUILD_TYPE="Release"
```
### macOS
Install necessary tooling:
- [Xcode](https://developer.apple.com/xcode/) and [Command Line Tools](https://developer.apple.com/download/all/).
- [Xcode](https://developer.apple.com/xcode/) and [Command Line Tools](https://developer.apple.com/download/all/)
- [Rust](https://rustup.rs/)
```sh
brew install cmake \
autoconf \
@@ -87,15 +105,18 @@ brew install cmake \
Then compile:
```sh
make palera1n WITH_STATIC=1 WITH_GUI=1
make palera1n"
```
### Debian / Ubuntu Linux
Install necessary tooling:
- [Rust](https://rustup.rs/)
```sh
sudo apt install -y build-essential \
sudo apt install -y \
build-essential \
cmake \
autoconf \
automake \
@@ -106,7 +127,7 @@ sudo apt install -y build-essential \
Then compile:
```sh
make palera1n WITH_STATIC=1 WITH_GUI=1
make palera1n
```
### Windows
@@ -116,9 +137,12 @@ make palera1n WITH_STATIC=1 WITH_GUI=1
Open mingw64 terminal and install necessary tooling:
```sh
pacman -S git \
pacman -S \
git \
mingw-w64-x86_64-toolchain \
mingw-w64-x86_64-cmake \
mingw-w64-x86_64-libusb \
mingw-w64-x86_64-rust \
libtool \
openssl \
openssl-devel \
@@ -134,29 +158,32 @@ pacman -S git \
Then compile:
```sh
make palera1n_mingw WITH_STATIC=1 WITH_GUI=1
make palera1n_mingw
```
## Acknowledgements
- [mineek](https://github.com/mineek) - Checkm8 exploit re-implementation (openra1n) using [gaster](https://github.com/0x7ff/gaster).
- [alfiecg24](https://github.com/mineek) - Achilles, based on openra1n.
- [kok3shidoll](https://github.com/kok3shidoll) - PongoOS patches, ROP chain generator.
- [itsnebulalol](https://github.com/itsnebulalol) - Palera1n v1.
- [staturnz](https://github.com/staturnz) - Contributions, Loader.
- [plooshi](https://github.com/plooshi) - Plooshfinder, various legacy patches.
- [nekohaxx](https://github.com/nekohaxx) - TUI.
- [checkra1n](https://checkra.in) - Checkra1n (1337), PongoOS, payloads, DFU helper & device assets.
- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice) - Libimobiledevice, libirecovery, libplist & usbmuxd.
- [libusb](https://github.com/libimobiledevice/libimobiledevice) - Library for access to usb-devices, used by libimobiledevice & openra1n.
- [Procursus](https://github.com/ProcursusTeam/Procursus) - Bootstrap & binpack.
- [tealbathingsuit](https://github.com/tealbathingsuit) - ElleKit.
- [sbingner](https://github.com/sbingner) - Substitute.
- [elihwyma](https://github.com/elihwyma) - Sileo & Pogo.
- [lrdsnow](https://github.com/lrdsnow) - tvOS package manager (PurePKG).
- [tihmstar](https://github.com/tihmstar) - jbinit v1
- [opa334](https://github.com/opa334) - cfprefs hook
- [mineek](https://github.com/mineek) - Checkm8 exploit re-implementation (libopenra1n), based off [gaster](https://github.com/0x7ff/gaster)
- [kok3shidoll](https://github.com/kok3shidoll) - Checkm8 (1337) exploit re-implementation (libciderra1n), PongoOS patches, ROP chain generator
- [checkra1n](https://checkra.in) - Checkra1n, PongoOS, payloads, DFU helper & device assets
- [staturnz](https://github.com/staturnz) - Liteusb, Loader contributions
- [libusb](https://github.com/libimobiledevice/libimobiledevice) - Library for access to usb-devices, used by libopenra1n
- [idevice](https://github.com/jkcoxson/idevice) - Library for access to usbmuxd devices
- [plooshi](https://github.com/plooshi) - Plooshfinder, plooshinit, various legacy patches
- [Procursus](https://github.com/ProcursusTeam/Procursus) - Bootstrap & binpack
- [tealbathingsuit](https://github.com/tealbathingsuit) - Tweak injection ([ElleKit](https://github.com/tealbathingsuit/ellekit))
- [sbingner](https://github.com/sbingner) - Substitute
- [elihwyma](https://github.com/elihwyma) - Package manager ([Sileo](https://github.com/Sileo/Sileo)) & [Pogo](https://github.com/elihwyma/Pogo)
- [kirb](https://github.com/kirb) - Package manager ([Zebra](https://github.com/zbrateam/Zebra))
- [lrdsnow](https://github.com/lrdsnow) - TvOS package manager ([PurePKG](https://github.com/Lrdsnow/purepkg)).
- [opa334](https://github.com/opa334) - Cfprefs hook
- [itsnebulalol](https://github.com/itsnebulalol) - Palera1n v1
- [llsc12](https://github.com/llsc12) - Palera1n loader v1
- [tihmstar](https://github.com/tihmstar) - Jbinit v1
- [nekohaxx](https://github.com/nekohaxx) - Contributions
## License
Project is licensed under the MIT license. You can see the full details of the license [here](https://github.com/khcrysalis/PlumeImpactor/blob/main/LICENSE).
Project is licensed under the MIT license. You can see the full details of the license [here](https://github.com/khcrysalis/PlumeImpactor/blob/main/LICENSE). Some components may be licensed under different licenses, see their respective directories for details.
Many things included in this program are made and developed by the Checkra1n team. Please do NOT contact the Checkra1n team for Palera1n, they are not responsible for this program. The original Checkra1n payloads are from [here](https://checkra.in/1337).