TrollStore

TrollStore

Developer(s)	opa334
Initial release	3 Sep 2022 (2022-09-03)
Stable release	2.0.15 / 30 March 2024
Repository	GitHub
Operating system	iOS
Available in	English
Type	Sideloading tool
Website	https://github.com/opa334/TrollStore

TrollStore is an on-device sideloading tool for iOS and iPadOS. It is used to install applications that are permanently-signed and that can possess arbitrary entitlements. This is only possible through exploitation of a CoreTrust, which allows to bypass code-signing checks and appear as an App Store-signed binary. The original TrollStore used the CoreTrust Root Certificate Validation Vulnerability, whereas TrollStore 2.0.0+ uses a new CoreTrust bug.

It currently supports iOS 14.0 - iOS 16.6.1, 16.7 RC (20H18), and 17.0. Some versions on arm64e will not be able to install TrollStore as of currently due to having an inaccessible installation method, and some versions of arm64 will require a jailbreak in order to install TrollStore. A full compatibility chart with installation guides is shown below.

From	To	arm64 (A8 - A11)	arm64e (A12 - A17 / M1 - M2)
13.7 and earlier		Unsupported
14.0	14.8.1	TrollHelper	TrollHelperOTA
15.0	15.5 beta 4	TrollHelperOTA
15.5		TrollInstallerMDC	TrollHelperOTA
15.6 beta	15.6 beta 4	TrollHelperOTA
15.6	15.6.1	TrollInstallerMDC	TrollHelperOTA
15.7	15.7.1	TrollInstallerMDC
15.7.2	15.8.1	TrollMisaka
16.0	16.1.2	TrollInstallerMDC
16.2	16.6.1	TrollStar
16.7 RC	16.7 RC	TrollHelper	No Installation Method
16.7	16.7.7	Unsupported
17.0	17.0	TrollHelper	No Installation Method
17.0.1 and later		Unsupported

Release History

Version	Release Date	Change log	Download URL
1.0	2 September 2022	Initial release	com.opa334.trollstorehelper_1.0_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.1	3 September 2022	Prevent opening undownloaded iCloud drive files Fix a bug where TrollStore would crash when installing big apps Show detailed error when an app install fails (Hopefully) fix a bug where TrollStore would wrongly abort an app install because it thinks an app with the id is already installed TrollStore Installer silent update 09/03/2022, 03:23 PST Support A12Z iPad Pro thanks to @udevsharold Support A10 iPads thanks to @lunjielee	com.opa334.trollstorehelper_1.0_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.2		TrollStore changes: Rework uicache code to work better, fixes bug in TrollStore installed apps (rebuild icon cache after updating) Add force install option on already installed error Some more bug fixes and stuff TrollInstaller changes: Support for more iPads, if it still doesn't work for you, check https://gist.github.com/opa334/192dc36e8a6db4c0fe316de271d91a5f	trollstorehelper_1.0.2_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.3		Fix installation (sorry about that) Entitlement dumping no longer needs ldid installed Use ldid -s flag instead of -S -M Add "Uninstall TrollStore" option to persistence helper	com.opa334.trollstorehelper_1.0.3_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.4	4 September 2022	Fix an issue where the ldidless entitlement dumping code would not work on non FAT binaries	com.opa334.trollstorehelper_1.0.4_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.5		Installer: Should work on A15 iPads now silent update: added ipod 7 support Store: Installed apps should now get notification permissions (Notifications work now, but App Plugins still don't, so support is limited) (For already installed apps, just open the IPA in TrollStore once more) Fix (un)installation of apps with weird file permissions (e.g. unc0ver) Fix installing IPAs that are on iCloud Drive	com.opa334.trollstorehelper_1.0.5_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.6	5 September 2022	Fix app plugins To make app plugins work for already installed apps, select "Rebuild Icon Cache" in TrollStore settings	com.opa334.trollstorehelper_1.0.6_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.7	6 September 2022	Don't resign an app when the main binary is already signed with a fake root certificate Don't resign an app when the Info.plist has a TSBundlePreSigned key that's set to YES If ldid is not installed and an app is unsigned, throw an error instead of installing it because it would just crash on launch anyways Improve entitlement dumping by using a system API instead of homebrewed file parsing code This update mostly consists of contributions by @luken11 ! Silent update: Add iPad Mini 6 support to TrollInstaller	com.opa334.trollstorehelper_1.0.7_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.8	9 September 2022	Pretend apps installed through TrollStore are ad hoc signed, not sure if this improves anything but I found some checks for it Remove apple owned URL schemes when installing apps, prevents apps from breaking system functionality (if you have such an app installed, reinstall the IPA after updating to TrollStore 1.0.8) Prevent deletion of group containers when another app is still uses it Fix another small file permission problem when installing some very specific IPAs Add a pop up when pressing an app in the list, currently only has an uninstall option Code improvments, more detailed error messages on installation failure	com.opa334.trollstorehelper_1.0.8_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.9	12 September 2022	Work around an ldid bug where the entitlements of root helpers would be stripped when signing them Improve app list in apps tab (icons, versions, bundle identifiers) (partitially thanks to contributions from @tylinux) Add an option to open an app to the menu that appears when pressing on an app in the apps tab (thanks to contributions from @SerenaKit)	com.opa334.trollstorehelper_1.0.9_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.0.10		Work around an ldid bug where the entitlements of root helpers would be stripped when signing them Improve app list in apps tab (icons, versions, bundle identifiers) (partitially thanks to contributions from @tylinux) Add an option to open an app to the menu that appears when pressing on an app in the apps tab (thanks to contributions from @SerenaKit)	com.opa334.trollstorehelper_1.0.10_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.1	22 September 2022	Sort app list by name Improve app borders even more, they should look like the ones in App Store now Fix an issue where apps with wrong icon sizes would appear incorrectly in TrollStore Fix incorrect icon sizes on iPads Kill apps when they are uninstalled Improve uicache implementation a bit (should not bring any notable improvements though) When a new TrollStore update is available, it will now show in both TrollStore settings and inside the (persistence) helper app alongside a button to install it	com.opa334.trollstorehelper_1.1_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.1.1	29 September 2022	Work around some connectivity issues in TrollHelper and TrollStore on chinese devices Fix a bug where an app could not be uninstalled if it doesn't have an Info.plist	com.opa334.trollstorehelper_1.1.1_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.1.2	30 September 2022	Support opening/installing .tipa files, these are just .ipa files but renamed, unlike .ipa files they can be airdropped to your device however	com.opa334.trollstorehelper_1.1.2_iphoneos-arm.deb TrollInstaller.ipa TrollStore.tar
1.2	11 October 2022	Support detecting persistence helper installed into TrollHelperOTA user app Actually fix chinese connectivity issues(?), thanks to @Halo-Michael Fix persistence helper black screen when it's installed into apps that use a SceneDelegate TrollInstaller is now DEPRECATED and superseeded by TrollHelperOTA, installation guide available in README.	com.opa334.trollstorehelper_1.2_iphoneos-arm.deb TrollStore.tar
1.2.1	17 October 2022	New safety features ensuring it's impossible to install IPAs that have the same identifier as system applications already installed on the device Don't patch the Info.plist of TrollStore itself when updating TrollStore (important change to fix issues with updating to future updates)	com.opa334.trollstorehelper_1.2.1_iphoneos-arm.deb TrollStore.tar
1.2.2	18 October 2022	Improve the safety checks added in the previous version, now they only affect system apps that are immutable (any apps that are not stored inside /var/containers)	com.opa334.trollstorehelper_1.2.2_iphoneos-arm.deb TrollStore.tar
1.3	29 October 2022	Show alert with a lot of info about an app before installing it (Also available for already installed apps under "Show Details" when pressing them) Add plus button to top right of app list, allows installing an app from either the files app or from a URL Replace a system URL scheme that can be used by websites to directly open IPAs in TrollStore (Check README for more info) Add a search bar at the top of the app list Work around an issue where apps could become restricted for some reason (#292), if this happens to you, press "Reload Icon Cache" in TrollStore settings and it should fix itself Add an option to temporarily register a TrollStore installed app as "User" (It will not launch in this state, but it's useful for adjusting it's settings, using iTunes file sharing or using Apps Manager on it) Massive internal code refactors Add a launch screen to fix a broken animation when opening the TrollStore app Fix a bug where the persistence helper wouldn't show the uninstall button when injected into a system app NOTE: If you were not on 1.2.2 before installing this update, you will need to install the TrollStore tar twice (one time when you are already on 1.3) in order to get the URL scheme to work.	com.opa334.trollstorehelper_1.3_iphoneos-arm.deb TrollStore.tar
1.3.1	30 October 2022	Fix crash on pressing cancel button on install alert Fix installing IPAs from iCloud Drive when using the in app option	com.opa334.trollstorehelper_1.3.1_iphoneos-arm.deb TrollStore.tar
1.3.2		Allow TrollStore to access Metal, fixes app crashes when bold text is enabled Add info about what TCC apis / MobileGestalt keys an app can access, contributed by @luken11	com.opa334.trollstorehelper_1.3.2_iphoneos-arm.deb TrollStore.tar
1.3.4	31 October 2022	Fix Fugu15 not working when installed through TrollStore Make app details a little more accurate NOTE: The previously existant TSRootBinaries Info.plist is now depecrated and no longer needed, you might still want to include it to support older TrollStore versions NOTE: 1.3.3 had a bug where the update process was broken, if you updated to it and are in a broken state, use TrollHelper(OTA) to update to 1.3.4, sorry for the inconveniences.	com.opa334.trollstorehelper_1.3.4_iphoneos-arm.deb TrollStore.tar
1.3.5	6 November 2022	Fix #336 (Trollstore shows the size of the software which multiplied by the number of times "Show Details" is clicked.) Fix a bug with the update option in settings where it could wrongfully "update" to an outdated version of TrollStore in some rare edge cases	com.opa334.trollstorehelper_1.3.5_iphoneos-arm.deb TrollStore.tar
1.4	19 November 2022	Adapt FuguInstall method for installing apps as it may be a little bit better (This only applies to NEWLY installed apps, but it shouldn't matter too much, if you for some reason want an app to be installed through this new method, you need to uninstall it and then reinstall the IPA) Add a switch to enable / disable the TrollStore URL scheme (closes #344) Add an option to configure when installation confirmation alerts should be shown Fix an issue where apps in some cases could still replace system URL schemes, which would break system functionality TrollStore installed apps can now be uninstalled from home screen When uninstalling TrollStore, there now is an option to preserve the apps installed through it Various code improvements and other smaller fixes	com.opa334.trollstorehelper_1.4_iphoneos-arm.deb TrollStore.tar
1.4.1	20 November 2022	Fix all problems with apps getting restricted on iOS 14 once and for all Disable home screen uninstallations of TrollStore apps again, because doing this would also cause the app to get restricted (If you already have an issue with restricted apps, reload icon cache once after installing this update)	com.opa334.trollstorehelper_1.4.1_iphoneos-arm.deb TrollStore.tar
1.4.2		Fix an issue where apps could sometimes not be correctly marked as TrollStore apps, causing them to not appear in the TrollStore app list Fix a theoretical issue that could maybe happen in some rare cases while adding an app to icon cache	com.opa334.trollstorehelper_1.4.2_iphoneos-arm.deb TrollStore.tar
1.4.3	21 November 2022	Fix app group and plugin containers not being removed when uninstalling an app	com.opa334.trollstorehelper_1.4.3_iphoneos-arm.deb TrollStore.tar
1.4.4	22 November 2022	Revert to old installation method, as the FuguInstall method caused too many weird unexplainable issues	com.opa334.trollstorehelper_1.4.4_iphoneos-arm.deb TrollStore.tar
1.4.5	1 December 2022	Fix issues when installing apps that have a "com.apple" identifier prefix Fix an issue in the uicache implementation that would cause group containers to not get removed when uninstalling an app from Home Screen (Home Screen uninstallations have therefore been reenabled but only on iOS 15, because iOS 14 still has the restriction issue) Fix an issue where the Fugu15 app could show as a destination for the persistence helper The option to refresh registrations in TrollHelper will now also show in the case where TrollStore itself has been uninstalled, but there are still TrollStore installed apps on the system Add an option to copy a debug log in case of installation failures	com.opa334.trollstorehelper_1.4.5_iphoneos-arm.deb TrollStore.tar
1.5.0	29 January 2023	Add „Advanced“ settings tab, contains the ability to switch between „installd“ and „Custom“ (un)installation methods Separate ldid updates from TrollStore updates, newest ldid version fixes a bug that TrollStore previously had to ship a hacky workaround for, this workaround was removed now ldid will now be automatically installed/updated on TrollStore app launch when it’s either not installed already or the installed version is too outdated for the TrollStore version to support it Fix an issue where uninstalling some applications could fail Automatically make the „Reload Icon Cache“ button fix a stock iOS issue where a bloated icon cache could cause app installs and updates to cause severe system wide lag spikes (previously reloading icon cache did not fix this bloat issue, now it does) Fix a bug where the group containers of app plugins could be incorrectly registered Switch to TrollStore’s own CoreTrust certificate in favour of the previous „Worth doing badly“ certificate	com.opa334.trollstorehelper_1.5.0_iphoneos-arm.deb TrollStore.tar
1.5.1	14 February 2023	Fix crash on uninstallation	com.opa334.trollstorehelper_1.5.1_iphoneos-arm.deb TrollStore.tar
2.0	27 November 2023	DO NOT INSTALL THIS ON IOS 14!!!!!!!!!!!!!!!!!!!!!! DO NOT INSTALL THIS ON IOS 14!!!!!!!!!!!!!!!!!!!!!! DO NOT INSTALL THIS ON IOS 14!!!!!!!!!!!!!!!!!!!!!! Add support for iOS 15.5 - 16.6.1, 17.0 thanks to CVE-2023-41991 (Note that not all devices / versions have an install method, kfd devices will get one shortly by misaka, checkm8 devices can use the TrollHelper package, the arm64e OTA method has been updated to support a few more versions of iOS 15, which exactly we do not know yet, but 15.5 is definitely supported by it now) Fix some minor bug where TrollStore wouldn't delete an apps data container when uninstalling it Remove dependency on ldid Add donation links Uses ChOma library for MachO parsing (not in the best state right now but it works for applying the bypass :D): https://github.com/opa334/ChOma Big thanks to @alfiecg24 for providing the bypass and helping with automating it using ChOma and @TheRealClarity for some minor contributions to ChOma. For early installing: If you can manage to replace a removable system app with PersistenceHelper_Embedded (using MDC / kfd), then reboot the device and run it afterwards, the replaced app can be used to install TrollStore.	com.opa334.trollstorehelper_2.0.0_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.0_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.1		Fix an issue with signing binaries that have load commands that ChOma doesn't understand (e.g. oobPCI inside Dopamine) Fix an edge case that could cause trollstorehelper to crash when it can't find the code directory (as with the case above)	com.opa334.trollstorehelper_2.0.1_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.1_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.2	28 November 2023	Reintroduce ldid as the signing method on iOS 14 because apparently the CodeSigning APIs TrollStore uses now were only introduced in iOS 15 :/, the previous two updates were broken so badly on iOS 14 that you cannot even update to this one using the app or a persistence helper installed into a system app anymore, to update use the method you originally installed TrollStore with, e.g. GTA Car Tracker or TrollHelper package if jailbroken, iOS 14 users who are still on 1.x can update to this one fine, sorry for the inconvienience!	com.opa334.trollstorehelper_2.0.2_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.2_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.3		Use ldid on all versions again because there was a problem with Security.framework related to signing embedded frameworks that I couldn't find the fix for, when signing with ldid this problem does not occur so it will be used for the time being until I can find a fix or better solution	com.opa334.trollstorehelper_2.0.3_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.3_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.4		Apparently ldid signed binaries do not work on iOS 16+ so we use Security.framework on iOS 16+ again (and yes, this still has the issue with embedded frameworks, that fix is still pending :/ but at least it doesn't affect 14-15 for now)	com.opa334.trollstorehelper_2.0.4_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.4_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.5		Switch all versions back to ldid since the root cause of it not working on 15.5+ was that the ldid binary hosted on my GitHub wasn't signed with the new CoreTrust bug.... So ldid works on all versions now and that should fix all app crashing issues now (Make sure you update ldid to v2.1.5-procursus7-new in settings)	com.opa334.trollstorehelper_2.0.5_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.5_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.6		Fix all installed apps getting the same data container (Apps installed with TrollStore 2.0.0 - 2.0.5 need to be reinstalled for this to be fixed for them) Sync latest uicache changes from Procursus (Had one additional bug fix) Fix some more uicache inaccuracies with data containers that I only noticed now due to the new data container fix now	com.opa334.trollstorehelper_2.0.6_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.6_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.7		Restore support for apps that have the com.apple.private.security.no-sandbox entitlement (got broken in 2.0.6) (e.g. Dopamine, TrollSpeed, etc.)	com.opa334.trollstorehelper_2.0.7_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.7_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.8	29 November 2023	Fix chinese wifi issues on iOS 16+ (Contributed by @Halo-Michael) Deprecate TSBundlePreSigned in favour of TSPreAppliedExploitType (1 for signed with old bug, 2 for signed with new bug) TSBundlePreSigned=1 is treated as TSPreAppliedExploitType=1 (Contributed by @luken11)	com.opa334.trollstorehelper_2.0.8_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.8_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.9	11 January 2024	Add the ability for TrollStore itself to enable developer mode on iOS 16+ (Contributed by @dhinakg) Add an error message when encrypted binaries are found	com.opa334.trollstorehelper_2.0.9_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.9_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.10	12 January 2024	Fix a 2.0.9 regression where app installations would fail with error 175 if any of the binaries contained inside the app had no entitlements at all Improve encryption detection code to not produce an error if only some binaries are encrypted, now as long as the main binary is decrypted, only a warning will be shown	com.opa334.trollstorehelper_2.0.10_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.10_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.11		Fix a UI bug where app icons could appear in the wrong row under certain conditions	com.opa334.trollstorehelper_2.0.11_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.11_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.12	26 January 2024	Add an option to launch an app with JIT (Only shown when the app has the get-task-allow entitlement) (Contributed by @khanhduytran0) Add a URL scheme to launch an app with JIT (apple-magnifier://enable-jit?bundle-id=<Bundle_ID>), this can allow a sandboxed app to semi-automatically get JIT, it will switch to TrollStore and then back to the app with JIT enabled (Only works when URL scheme is enabled in TrollStore settings!) (Contributed by @khanhduytran0) Fix a UI bug where icons of newly (un)installed applications would not update until restarting TrollStore if an icon had already been previously cached	com.opa334.trollstorehelper_2.0.12_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.12_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.13	3 March 2024	Don’t apply CoreTrust bypass to DWARF MachO files Add skip-uicache option to the TrollStore root helper Apply CoreTrust bypass using OpenSSL instead of a template signature blob (contributed by @dhinakg)	com.opa334.trollstorehelper_2.0.13_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.13_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.14	27 March 2024	Fix inaccurate pre-applied exploit type identification (contributed by @luken11) Fix ldid and the CoreTrust bypass sharing the same error code	com.opa334.trollstorehelper_2.0.14_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.14_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar
2.0.15	30 March 2024	Fix inaccurate error description when installing an app with additional encrypted binaries (2.0.14 regression) Add option in the root helper to specify root helper and persistence helper executable paths when installing a persistence helper	com.opa334.trollstorehelper_2.0.15_iphoneos-arm.deb com.opa334.trollstorehelper_2.0.15_iphoneos-arm64.deb PersistenceHelper_Embedded TrollStore.tar