MCPcopy Index your code
hub / github.com/JJTech0130/TrollRestore

github.com/JJTech0130/TrollRestore @1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.0 ↗ · + Follow
25 symbols 95 edges 4 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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.

A guide for installing TrollStore using TrollRestore can be found here.

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.

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.

Need Help?

If you run into any issues during the installation, you can get support on the r/Jailbreak Discord server.

Credits

  • JJTech - Sparserestore (the main library used to restore the TrollHelper binary)
  • Nathan - Turning sparserestore into a TrollStore installer
  • Mike, Dhinak G - Various improvements to the installer
  • doronz88 - pymobiledevice3
  • opa334, Alfie - TrollStore
  • Aaronp613 - Minor improvements

Core symbols most depended-on inside this repo

from_bytes
called by 19
sparserestore/mbdb.py
to_bytes
called by 18
sparserestore/mbdb.py
exit
called by 5
trollstore.py
perform_restore
called by 2
sparserestore/__init__.py
cli
called by 1
trollstore.py
main
called by 1
trollstore.py
to_record
called by 1
sparserestore/backup.py
write_to_directory
called by 1
sparserestore/backup.py

Shape

Method 12
Class 8
Function 5

Languages

Python100%

Modules by API surface

sparserestore/backup.py13 symbols
sparserestore/mbdb.py7 symbols
trollstore.py3 symbols
sparserestore/__init__.py2 symbols

For agents

$ claude mcp add TrollRestore \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact