From 8d1851ffbb9fff6555bc8b5cec666a4c6e3ab1b8 Mon Sep 17 00:00:00 2001 From: opa334 Date: Thu, 8 Sep 2022 00:56:55 +0200 Subject: [PATCH] Add installation methods --- PersistenceHelper/control | 4 ++-- README.md | 33 +++++++++++++++++++++++++++++++++ install_trollhelper.md | 11 +++++++++++ install_trollinstaller.md | 17 +++++++++++++++++ install_with_sshrd.md | 26 +++++++++++++++----------- 5 files changed, 78 insertions(+), 13 deletions(-) create mode 100644 install_trollhelper.md create mode 100644 install_trollinstaller.md diff --git a/PersistenceHelper/control b/PersistenceHelper/control index eb49441..79688ea 100644 --- a/PersistenceHelper/control +++ b/PersistenceHelper/control @@ -2,7 +2,7 @@ Package: com.opa334.trollstorehelper Name: TrollStore Helper Version: 1.0.7 Architecture: iphoneos-arm -Description: Helper app to install and manage TrollStore! +Description: Helper utility to install and manage TrollStore! Maintainer: opa334 Author: opa334 -Section: Utilities +Section: Applications diff --git a/README.md b/README.md index 8a4e4c6..272346e 100644 --- a/README.md +++ b/README.md @@ -7,3 +7,36 @@ A proper readme will be added shortly, for now see the release post on [reddit]( The CoreTrust bug only affects 14.0 - 15.5b4, TrollStore will most likely never support any versions outside that range. 15.2 and up are unsupported currently as there is no way to install TrollStore to these versions until the install method of Fugu15 is public. + +## Installation Methods + +| Version / Device | A8 | A9 | A10 | A11 | A12 | A13 | A14 | A15 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | +| iOS 14.0 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.0.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.2 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.2.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.3 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.4 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.4.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.4.2 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.5 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.5.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | N/A | +| iOS 14.6 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | None | N/A | +| iOS 14.7 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | None | N/A | +| iOS 14.7.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | None | N/A | +| iOS 14.8 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | None | N/A | +| iOS 14.8.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | None | None | None | N/A | +| iOS 15.0 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | +| iOS 15.0.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | +| iOS 15.0.2 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | +| iOS 15.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | +| iOS 15.1.1 | N/A | N/A | N/A | N/A | N/A | N/A | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | +| iOS 15.2 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.2.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.3 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.3.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.4 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.4.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | +| iOS 15.5b5 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | None | None | None | None | \ No newline at end of file diff --git a/install_trollhelper.md b/install_trollhelper.md new file mode 100644 index 0000000..7398f2c --- /dev/null +++ b/install_trollhelper.md @@ -0,0 +1,11 @@ +# Installation through TrollStore Helper + +**Supported devices:** All jailbroken devices between iOS 14.0 and 15.5b4 + +1. Download TrollStore Helper from Havoc repo (https://havoc.app), alternatively you can also download the deb from releases and install it yourself. + +2. Open TrollStore Helper on the home screen + +3. Press "Install TrollStore", make sure you're connected to internet + +4. Done, your device will respring and TrollStore should appear on your home screen \ No newline at end of file diff --git a/install_trollinstaller.md b/install_trollinstaller.md new file mode 100644 index 0000000..7af12ae --- /dev/null +++ b/install_trollinstaller.md @@ -0,0 +1,17 @@ +# Installation through TrollInstaller + +**Supported devices:** A10 - A15, iOS 15.0 - 15.1.1 + +1. Download the TrollInstaller IPA from releases and install it to your device using your method of choice (AltStore / Sideloadly / Xcode / ...) + +2. Open TrollInstaller + +3. Press the Install button at the bottom + +4. If your phone reboots here, go back to step 2 + +5. An alert should pop up when TrollStore installed sucessfully, click close and the app should exit + +6. If TrollStore is on home screen, start it, if not then reboot and it should appear afterwards, then start it + +7. **(Optional)** Tap "Install Persistence Helper" and choose a system app you don't need to use (e.g. Tips) in the list that appears, this app can later be used to refresh TrollStore registrations when iOS reloads the icon cache and the TrollStore apps no longer launch \ No newline at end of file diff --git a/install_with_sshrd.md b/install_with_sshrd.md index 9d699c1..d7f350f 100644 --- a/install_with_sshrd.md +++ b/install_with_sshrd.md @@ -1,14 +1,16 @@ -# Install TrollStore with a SSH Ramdisk (Linux and macOS only) +# Installation through an SSH Ramdisk (Linux and macOS only) -1. download this tar and extract it https://github.com/opa334/TrollStore/releases/latest/download/TrollStore.tar +**Supported devices:** A8 - A11, iOS 14.0 - 15.5b4 -2. run `git clone https://github.com/verygenericname/SSHRD_Script --recursive && cd SSHRD_Script` +1. Download this tar and extract it https://github.com/opa334/TrollStore/releases/latest/download/TrollStore.tar -3. run `./sshrd.sh ` +2. Run `git clone https://github.com/verygenericname/SSHRD_Script --recursive && cd SSHRD_Script` -4. run `./sshrd.sh boot` the device should start verbosing and say OK in ascii +3. Run `./sshrd.sh ` -5. in a new terminal window, run `iproxy 2222 22` +4. Run `./sshrd.sh boot` the device should start verbosing and say OK in ascii + +5. In a new terminal window, run `iproxy 2222 22` 6. In the previous window, run `ssh -p2222 root@localhost`, the pass is alpine @@ -19,11 +21,11 @@ 9. For the app you would like to replace, run `grep -r "" .` - you can put something like Tips, must be a deletable system app -10. look for a filepath that looks like `.//.app` +10. Look for a filepath that looks like `.//.app` -11. run `cd /.app` +11. Run `cd /.app` -12. run `mv _TROLLSTORE_BACKUP` +12. Run `mv _TROLLSTORE_BACKUP` 13. Now, in another terminal window, cd into the folder of the tar you extracted earlier @@ -33,6 +35,8 @@ 16. In the window you sshed into the phone in, run `chown 33 & chmod 755 trollstorehelper & chown 0 trollstorehelper`, and run `reboot`, your phone will reboot into iOS -17. Open up the app you replaced, it should show some buttons like install trollstore, click install trollstore +17. Open up the app you replaced, it should be TrollStore Helper now -18. TrollStore is installed! +18. Press "Install TrollStore", make sure you're connected to internet + +19. Done, your device will respring and TrollStore should appear on your home screen