Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: JJTech0130/TrollRestore
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 1.0
Choose a base ref
...
head repository: JJTech0130/TrollRestore
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: main
Choose a head ref
  • 8 commits
  • 1 file changed
  • 4 contributors

Commits on Sep 2, 2024

  1. Clarified computer support

    aaronp613 committed Sep 2, 2024
    Copy the full SHA
    840c58b View commit details

Commits on Sep 3, 2024

  1. Fix small typo

    TheMasterOfMike authored Sep 3, 2024
    Copy the full SHA
    9be631a View commit details
  2. Copy the full SHA
    c69db03 View commit details
  3. Copy the full SHA
    80d5ebd View commit details
  4. Fix typo

    alfiecg24 authored Sep 3, 2024
    Copy the full SHA
    84d50e1 View commit details

Commits on Sep 4, 2024

  1. TrollRestore doesn't work on 15.0-15.1.1

    Same issue as 14.x, likely unfixable.
    Validated to not be a pmd3 issue through Cowabunga Lite.
    TheMasterOfMike authored Sep 4, 2024
    Copy the full SHA
    69f6d0a View commit details

Commits on Sep 7, 2024

  1. Update README.md

    alfiecg24 authored Sep 7, 2024
    Copy the full SHA
    8efae43 View commit details

Commits on Oct 28, 2024

  1. CVE-2024-44252

    TheMasterOfMike authored Oct 28, 2024
    Copy the full SHA
    082f252 View commit details
Showing with 14 additions and 9 deletions.
  1. +14 −9 README.md
23 changes: 14 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,33 @@
# TrollRestore
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 is a TrollStore installer for iOS/iPadOS 15.2 - 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 via [CVE-2024-44252](https://support.apple.com/en-us/121563#:~:text=Mina%2C%20Ismail%20Amzdak-,MobileBackup,-Available%20for%3A%20iPhone) in order to restore the binary to a system app container.

A guide for installing TrollStore using TrollRestore can be found [here](https://ios.cfw.guide/installing-trollstore-trollrestore).

# Usage
To run the script, clone this repository and run the following commands:
```sh
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
python3 trollstore.py
```

# 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.

# Version Support
As stated above, this installer supports iOS/iPadOS 15.0 - 16.7 RC (20H18) and 17.0.
# iOS Version Support
As stated above, this installer supports iOS/iPadOS 15.2 - 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.
It should theoretically support iOS 14 and iOS 15.0 - 15.1.1, but during our testing, we experienced issues restoring the backup to an iOS 14 device, and later also found the same issues with devices on iOS 15.0 - 15.1.1. Therefore, using TrollRestore on a device below iOS 15 has been disabled for the time being.

Note: It's not currently disabled for 15.0 - 15.1.1, due to these issues not being discovered until after TrollRestore released.

# Computer Requirements
To use the precompiled builds, you will either need:

macOS: A Mac with macOS 11 (Big Sur) or higher.

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

# Need Help?
If you run into any issues during the installation, you can get support on the [r/Jailbreak Discord server](https://discord.gg/jb).