TrollRestore 1.0 Installation Guide

TrollRestore is a TrollStore installer for iOS/iPadOS 15.0 – 16.7 RC (20H18) and 17.0. It will replace a system app of your choice with a TrollHelper binary, which you can then open and use to install TrollStore. TrollRestore makes use of backups in order to restore the binary to a system app container.

TrollRestore 1.0 supports 15.0 – 16.7 RC (20H18), and 17.0.

Initial Release

Known Issues

  • The Intel macOS build (TrollRestore_macOS_amd64.zip) is not currently notarized
    • This is due to technical issues when attempting to notarize stuff for Intel-based Macs (in part due to most people involved who can notarize having an Apple Silicon Mac)
  • There is currently no in-script version listing (e.g. “TrollRestore 1.0”)

Usage

To run the script, clone this repository and run the following commands:

pip install -r requirements.txt
python3 trollstore.py [system app]

If you’re unsure about which app to use, just use Tips, like so:python3 trollstore.py Tips

Post-installation

TrollRestore does not restore a proper persistence helper – it simply replaces the main binary of a system app with an embedded TrollHelper. Thus, after installing TrollStore, it is recommended to install a persistence helper (you can use the same app used with TrollRestore as your persistence helper). Due to the nature of the installer (and its use of backups), the only way to restore your chosen app to it’s original state is to delete it and re-install the app from the App Store.

iOS Version Support

As stated above, this installer supports iOS/iPadOS 15.0 – 16.7 RC (20H18) and 17.0.

Note: All 4 versions of iOS 17.0 are supported: 21A326/21A327/21A329/21A331

It should theoretically support iOS 14, but during our testing, we experienced issues restoring the backup to an iOS 14 device. Therefore, using TrollStore on a device below iOS 15 has been disabled for the time being.

Computer Requirements

To use the precompiled builds, you will either need:

macOS: A Mac with macOS 12 (Monterey) or higher. macOS 11 may work but has not been tested.

Windows: A PC running Windows 10 or higher. iTunes must be installed.