From a8be6af56f3db65e247b3c5703e9729a3f939c73 Mon Sep 17 00:00:00 2001 From: opa334 Date: Sat, 5 Nov 2022 23:31:39 +0100 Subject: [PATCH] Better Installation Guides --- README.md | 67 ++++++-------------------------- install_sshrd.md | 29 ++++++++++++++ install_trollhelper.md | 31 +++++++++++++++ install_trollhelperota_arm64e.md | 25 ++++++++++++ install_trollhelperota_ios15.md | 25 ++++++++++++ 5 files changed, 121 insertions(+), 56 deletions(-) create mode 100644 install_sshrd.md create mode 100644 install_trollhelper.md create mode 100644 install_trollhelperota_arm64e.md create mode 100644 install_trollhelperota_ios15.md diff --git a/README.md b/README.md index 68b9127..58d46d6 100644 --- a/README.md +++ b/README.md @@ -20,63 +20,18 @@ Anything not supported right now will **_NEVER_** be supported, TrollStore is a ### Installation Links -[TrollHelperOTA Link 1 - Supports all devices on iOS 15 and up](https://api.jailbreaks.app/troll) +| Version / Device | arm64 | arm64e +| <=13.7 | Not Supported | Not Supported +| 14.0 - 14.8.1 | [checkra1n + TrollHelper](./install_trollhelper.md) | [TrollHelperOTA (arm64e)](./install_trollhelperota_arm64e.md) +| 15.0 - 15.4.1 | [TrollHelperOTA (iOS 15+)](./install_trollhelperota_ios15.md) | [TrollHelperOTA (iOS 15+)](./install_trollhelperota_ios15.md) +| 15.5 beta 1 - 4 | [TrollHelperOTA (iOS 15+)](./install_trollhelperota_ios15.md) | [TrollHelperOTA (iOS 15+)](./install_trollhelperota_ios15.md) +| 15.5 RC | Not Supported | Not Supported +| 15.5 | Not Supported | Not Supported +| 15.6 beta 1 - 5 | [SSH Ramdisk](./install_sshrd.md) | [TrollHelperOTA (arm64e)](./install_trollhelperota_arm64e.md) +| 15.6 RC1/2 | Not Supported | Not Supported +| >=15.6 | Not Supported | Not Supported -[TrollHelperOTA Link 2 - Supports all arm64e (A12 - A15) devices on iOS 14 and up](https://api.jailbreaks.app/troll64e) - -Please refer to "Compatibility" above to check whether your version is compatible, if it's not, these links will not work. - -This installation method unfortunately does **NOT** work on arm64 (A8 - A11) iOS 14 devices. **HOWEVER**, for these devices, you can jailbreak with checkra1n and then use the jailbroken installation guide below. - -### Guide (No Jailbreak) - -1. Based on what device you are using, pick one of the two links above and open it. - -2. An alert should appear, tap "Install" - -3. When the installation is finished, you will find a "GTA Car Tracker" application on your device. - -4. If this app has not appeared, that's a stock iOS bug, reboot your device and the app will appear. - -5. Launch the app, tap "Install TrollStore" - -6. Wait a few seconds, your device should respring and TrollStore will be installed. - -7. You can now either delete the "GTA Car Tracker" app, or register it as the persistence helper by opening it and tapping the option at the bottom. If you do this, don't delete the app. - -8. Open the TrollStore app and press "Install ldid" in the Settings tab, then read the information under "Persistence", and install the Persistence Helper into a system app if you want persistence (not needed if you registered the GTA Car Tracker app as the persistence helper in step 7). - -9. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device. - -## Installing TrollStore (Jailbreak) - -Supports jailbroken devices running 14.0 and above. - -### Guide - -1. Open your package manager, and make sure [Havoc repo](https://havoc.app) is added under Sources, then search for "TrollStore Helper" and install it. - -2. After the installation, respring and the "TrollHelper" app should have appeared on your home screen. - -3. Launch the app, tap "Install TrollStore" - -4. Wait a few seconds, your device should respring and TrollStore will be installed. - -5. Open the TrollStore app and press "Install ldid" in the Settings tab, then read the information under "Persistence", the TrollHelper app on the home screen will be your persistence helper. - -6. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device. - -### Unjailbreaking while retaining TrollStore - -Some people might prefer to use TrollStore in an unjailbroken environment, if that applies to you, follow this guide. - -1. Uninstall TrollHelper from your package manager - -2. Now when you launch TrollStore, it will have an option to install the persistence helper into a System app like on iOS 15, do so. - -3. Now restore rootFS through your jailbreak app, afterwards use the System app to refresh app registrations. - -4. Done, your device will be jailed, but TrollStore will still work. +This version table is final, TrollStore will never support anything other than the versions listed as supported here. Do not bother asking, if you got a device on an unsupported version, it's best if you forget TrollStore even exists. ## Updating TrollStore diff --git a/install_sshrd.md b/install_sshrd.md new file mode 100644 index 0000000..c035743 --- /dev/null +++ b/install_sshrd.md @@ -0,0 +1,29 @@ +# SSH Ramdisk + +## Supported Devices: All checkm8 / arm64 devices + +## Supported Versions: iOS 14.0 - 15.5b4, 15.6b1 - 15.6b5 + +## Additional requirements: Linux / macOS Computer + +## Guide + +Video tutorial: https://youtu.be/B0MueVvJSK4 + +1. Run `git clone https://github.com/verygenericname/SSHRD_Script --recursive && cd SSHRD_Script` + +2. Run `./sshrd.sh TrollStore ` + - Make sure to **not** include the `<>` + - The uninstallable system app should be an app you don't need to use (e.g. Tips) + - i.e. `./sshrd.sh 15.0 TrollStore Tips` + +3. Put your device into DFU mode. Instructions for this can be found [here](https://www.theiphonewiki.com/wiki/DFU_Mode#iPhone.2C_iPad.2C_iPod_touch). + - If you are on an A11 device, entire recovery mode first by pressing and quickly releasing the volume up and volume down button, one at a time. Then, press and hold the side button until you see the recovery mode screen. Finally, put your device into DFU mode as said above. + +4. Run `./sshrd.sh boot` the device should start verbosing and show a TrollFace in ascii, then reboot eventually + +5. Open up the app you replaced (Tips in this example), it should be TrollStore Helper now. + +6. Make sure you're connected to the internet, and press "Install TrollStore." + +7. Done, your device will respring and TrollStore should appear on your home screen. \ No newline at end of file diff --git a/install_trollhelper.md b/install_trollhelper.md new file mode 100644 index 0000000..a51b57d --- /dev/null +++ b/install_trollhelper.md @@ -0,0 +1,31 @@ +# TrollHelper + +## Supported Devices: All jailbroken devices + +## Supported Versions: iOS 14.0 - 15.5b4, 15.6b1 - 15.6b5 + +## Guide + +1. Open your package manager, and make sure [Havoc repo](https://havoc.app) is added under Sources, then search for "TrollStore Helper" and install it. + +2. After the installation, respring and the "TrollHelper" app should have appeared on your home screen. + +3. Launch the app, tap "Install TrollStore" + +4. Wait a few seconds, your device should respring and TrollStore will be installed. + +5. Open the TrollStore app and press "Install ldid" in the Settings tab, then read the information under "Persistence", the TrollHelper app on the home screen will be your persistence helper. + +6. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device. + +## Unjailbreaking while retaining TrollStore + +Some people might prefer to use TrollStore in an unjailbroken environment, if that applies to you, follow this guide. + +1. Uninstall TrollHelper from your package manager + +2. Now when you launch TrollStore, it will have an option to install the persistence helper into a System app like on iOS 15, do so. + +3. Now restore rootFS through your jailbreak app, afterwards use the System app to refresh app registrations. + +4. Done, your device will be jailed, but TrollStore will still work. diff --git a/install_trollhelperota_arm64e.md b/install_trollhelperota_arm64e.md new file mode 100644 index 0000000..8d51de4 --- /dev/null +++ b/install_trollhelperota_arm64e.md @@ -0,0 +1,25 @@ +# TrollHelperOTA (arm64e) + +## Supported Devices: All arm64e (A12 - A15) devices + +## Supported Versions: iOS 14.0 - 15.5b4, 15.6b1 - 15.6b5 + +## Guide + +1. On your device, go to the following link: https://api.jailbreaks.app/troll64e + +2. An alert should appear, tap "Install" + +3. When the installation is finished, you will find a "GTA Car Tracker" application on your device. + +4. If this app has not appeared, that's a stock iOS bug, reboot your device and the app will appear. + +5. Launch the app, tap "Install TrollStore" + +6. Wait a few seconds, your device should respring and TrollStore will be installed. + +7. You can now either delete the "GTA Car Tracker" app, or register it as the persistence helper by opening it and tapping the option at the bottom. If you do this, don't delete the app. + +8. Open the TrollStore app and press "Install ldid" in the Settings tab, then read the information under "Persistence", and install the Persistence Helper into a system app if you want persistence (not needed if you registered the GTA Car Tracker app as the persistence helper in step 7). + +9. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device. diff --git a/install_trollhelperota_ios15.md b/install_trollhelperota_ios15.md new file mode 100644 index 0000000..f8bf078 --- /dev/null +++ b/install_trollhelperota_ios15.md @@ -0,0 +1,25 @@ +# TrollHelperOTA (iOS 15) + +## Supported Devices: All devices + +## Supported Versions: iOS 15.0 - 15.5b4 + +## Guide + +1. On your device, go to the following link: https://api.jailbreaks.app/troll + +2. An alert should appear, tap "Install" + +3. When the installation is finished, you will find a "GTA Car Tracker" application on your device. + +4. If this app has not appeared, that's a stock iOS bug, reboot your device and the app will appear. + +5. Launch the app, tap "Install TrollStore" + +6. Wait a few seconds, your device should respring and TrollStore will be installed. + +7. You can now either delete the "GTA Car Tracker" app, or register it as the persistence helper by opening it and tapping the option at the bottom. If you do this, don't delete the app. + +8. Open the TrollStore app and press "Install ldid" in the Settings tab, then read the information under "Persistence", and install the Persistence Helper into a system app if you want persistence (not needed if you registered the GTA Car Tracker app as the persistence helper in step 7). + +9. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device.