open-source/TrollStore
1
0
Fork 0
mirror of https://github.com/opa334/TrollStore.git synced 2026-08-17 15:26:57 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Deprecate all installation methods, TrollInstaller2 is now the preferred way to install TrollStore on all supported devices

Browse Source
This commit is contained in:
opa334
2022-10-09 22:04:20 +02:00
parent 08df46dcd6
commit ff73d50b73
5 changed files with 20 additions and 140 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+20 -33
View File
@@ -6,44 +6,31 @@ It works because of the CoreTrust bug that **_ONLY_** affects iOS 14.0 - 15.4.1
**NOTE: TrollStore will _NEVER_ work on anything higher than iOS 15.5 beta 4 (No not on iOS 15.5, not on iOS 15.6 and certainly not on iOS 16.x), please stop asking!**
## Installation Methods
## Installing TrollStore
N/A means: No device / version combination exists
1. On your iOS device (14.0 - 15.5b4), click [this link](https://api.jailbreaks.app/troll).
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.0.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.2 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.2.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.3 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.4 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.4.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.4.2 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.5 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.5.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.6 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.7 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.7.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.8 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | N/A |
| iOS 14.8.1 | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollHelper](./install_trollhelper.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| iOS 15.1 | [SSH Ramdisk](./install_with_sshrd.md) | [SSH Ramdisk](./install_with_sshrd.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller](./install_trollinstaller.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| iOS 15.1.1 | N/A | N/A | N/A | N/A | N/A | N/A | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
| iOS 15.5 Beta 1 - Beta 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) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) | [TrollInstaller2](./install_trollinstaller2.md) |
2. An alert should appear, click "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 it 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 delete the "GTA Car Tracker" app, it is no longer needed
8. Open TrollStore and press "Install ldid" in the Settings tab, then read the information under "Persistence", and install Persistence Helper if want persistence.
9. Done, you can now share IPA files with TrollStore and they will be permanently installed on your device
# Updating TrollStore
After installing TrollStore, you can update it to newer versions by opening the .tar file in releases in TrollStore. It will install the update and respring afterwards.
When a new TrollStore update is available, a button to install it will appear at the top in the TrollStore settings. When tapping the button, TrollStore will automatically download the update, install it and respring.
Alternatively (if anything goes wrong), you can download the TrollStore.tar file under Releases and open it in TrollStore, TrollStore will install the update and respring.
# Uninstalling an app
install_trollhelper.md
-13
View File
@@ -1,13 +0,0 @@
# Installation through TrollStore Helper
**Supported devices:** All **jailbroken** devices on iOS versions **14.0 to 15.5b4**
1. Download TrollStore Helper from Havoc repo (https://havoc.app).
Alternative: Directly download the .deb from GitHub releases and install it manually in your preferred package manager.
2. Open TrollStore Helper on the home screen.
3. Make sure you're connected to the internet, and press "Install TrollStore."
4. Done, your device will respring and TrollStore should appear on your home screen.
install_trollinstaller.md
-17
View File
@@ -1,17 +0,0 @@
# 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. **(Recommended)** Tap "Install Persistence Helper" in TrollStore 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
install_trollinstaller2.md
-52
View File
@@ -1,52 +0,0 @@
# Installation through TrollInstaller 2
**Supported devices:** A12 - A15, 14.0 - 15.4.1 (15.5b4)
## Installing pre-compiled application (Recommended)
All of these steps should be done on your iPhone/iPad; a computer is not needed.
1. Open [this link](https://api.jailbreaks.app/troll) on your device
2. Tap "Install" on the prompt
+ The app that appears on your home screen will be called "GTA Car Tracker"; this is normal.
3. Open the app and tap "Install TrollStore"
+ This will also trigger a respring
4. Open the newly-installed TrollStore and navigate to Settings.
5. Install ldid. Then, read the information under "Persistence", and install Persistence Helper if you would like it.
## Compiling pwned IPA (Advanced) (currently requires a Mac) (Needs _the newest_ [THEOS](https://theos.dev/docs/installation-macos) and [14.5 sdk](https://github.com/theos/sdks) installed)
0. Make sure Xcode and Command Line Tools are installed.
1. Run `git clone https://github.com/opa334/TrollStore ~/TrollStore`
2. Get ANY encrypted AppStore IPA using [ipatool](https://github.com/majd/ipatool)
- In this example, the "Developer" app by Apple will be used, this app only supports iOS 15 and up, for iOS 14 support replace `developer.apple.wwdc-Release` in the following commands with the identifier of an app that still supports iOS 14
- `brew tap majd/repo && brew install ipatool`
- (Optional if you haven't 'purchase' this free app) `ipatool purchase --country US -b developer.apple.wwdc-Release` (Change US to your app store region)
- `ipatool download -b developer.apple.wwdc-Release`
3. Rename the output ipa to `InstallerVictim.ipa`, and put it into `~/TrollStore/_compile/target/InstallerVictim.ipa`
4. Make sure you have Procursus `ldid` installed and added to your path! (https://github.com/ProcursusTeam/ldid)
- `brew uninstall ldid` (brew ldid is bad ldid if you have it)
- Rename the Procursus ldid for your arch to `ldid`, then do `chmod +x ~/Downloads/ldid`
- `sudo mv ~/Downloads/ldid /usr/local/bin`
5. cd into _compile and run `./build_trollinstaller2.sh` (`chmod +x ./build_trollinstaller2.sh` if you get a permission error)
6. Wait a bit, when done, there will be a `TrollInstaller2.ipa` in ~/TrollStore/_compile/out
### Using compiled IPA (does not neccessarily require a Mac if you obtained the IPA from non orthodox ways)
7. You can install that to a device using e.g. ideviceinstaller(do `brew install ideviceinstaller` then do `ideviceinstaller -i TrollInstaller2.ipa`)
- Alternatively, you can use Sideloadly if you select "Normal Installation".
- (Other methods may also work, but make sure you don't use a signing cert, you can also use an enterprise plist or something to install it via Safari as shown in Fugu15 demo, something like iFunBox may also work)
8. After installation, you can use the newly installed app on your device to install TrollStore
install_with_sshrd.md
-25
View File
@@ -1,25 +0,0 @@
# Installation through an SSH Ramdisk (Linux and macOS only)
**_**If you do not have a Mac or a Linux PC, make an Ubuntu live USB and boot from it on your computer. **_**
**Supported devices:** A8(X) - A11, iOS 14.0 - 15.5b4
Video tutorial: https://youtu.be/B0MueVvJSK4
1. Run `git clone https://github.com/verygenericname/SSHRD_Script --recursive && cd SSHRD_Script`
2. Run `./sshrd.sh <iOS version for ramdisk> TrollStore <uninstallable system app>`
- 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.