├── LICENSE └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2024 iOS Guides 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Install TrollRestore TrollStore Installer for iOS 17.0 - iOS 15.0 - Full Guide 2 | 3 | TrollRestore is a powerful PC-based TrollStore installer that allows you to install TrollStore on any iOS device running iOS 15.0 to iOS 17.0. Unlike previous methods like TrollInstallerX and TrollMisaka, TrollRestore offers a new and more streamlined installation process. With TrollRestore, you can now easily replace a system app with the TrollHelper binary, enabling TrollStore installation across all supported iOS versions. 4 | ## TrollRestore: The Ultimate TrollStore Installer for iOS 17.0 - iOS 15.0 5 | 6 | ## What is TrollRestore? 7 | 8 | TrollRestore is a specialized installer that allows you to easily set up TrollStore on devices running iOS/iPadOS 15.0 to 16.7 RC (20H18) and 17.0. By using TrollRestore, you can replace a system app with a TrollHelper binary, which you can then use to install TrollStore. This method leverages backups to restore the binary to the system app container, making the installation process seamless. 9 | 10 | ## iOS Version Compatibility: TrollRestore Support for iOS 15.0 to 17.0 11 | 12 | - iOS 15.0 - 16.7 RC (20H18) 13 | - iOS 17.0 (all builds: 21A326, 21A327, 21A329, 21A331) 14 | 15 | ## Requirements for Installing TrollRestore on iOS 15.0 - 17.0 Devices 16 | 17 | Before you begin, make sure you have the following: 18 | 19 | - A device running iOS/iPadOS 15.0 to 16.6.1, 16.7 RC (20H18), or 17.0. 20 | - The [latest version of Python 3](https://www.python.org/downloads) installed. 21 | - The [latest version of iTunes](https://www.apple.com/itunes/download/win64) installed on your Windows PC. 22 | - The [latest version of TrollRestore](https://github.com/JJTech0130/TrollRestore/releases) for your platform: 23 | - Windows: TrollRestore.exe 24 | - Apple Silicon Macs: TrollRestore_macOS_arm64.zip 25 | - Intel-based Macs: TrollRestore_macOS_amd64.zip 26 | - Linux: TrollRestore_Linux.zip 27 | - The [latest version of the TrollStore AppStore](https://iospack.com/apps/trollsme-trollstore/) installed on your iPhone or iPad. 28 | - Ensure you disable "Find My" before proceeding with the installation. Once completed, you can re-enable it. 29 | 30 | 31 | ## How to Install TrollRestore on iOS 15.0 to 17.0 32 | 33 | ### MacOS/Windows Users 34 | 35 | If you’re using an Intel-based Mac, the TrollRestore build isn't notarized. To run it: 36 | 37 | - **Option 1:** Double-click the file while holding the Control key (for macOS Sonoma or earlier). 38 | - **Option 2:** Open the file normally, go to System Settings > Privacy & Security, and select Open Anyway. 39 | 40 | If you encounter issues, consider following the Linux instructions, as they work across all platforms, though they are slightly more complex. 41 | 42 | ### How to Inject TrollStore Helper on macOS/Windows 43 | 44 | 1. **Locate the File:** 45 | - Open File Explorer (Windows) or Finder (macOS). 46 | - Navigate to the downloaded/extracted TrollRestore file (usually in the Downloads folder). 47 | 48 | 2. **Run TrollRestore:** 49 | - Double-click the TrollRestore file. 50 | - When prompted, type the name of the system app you want to overwrite (e.g., Tips) and press Enter. 51 | - The device will reboot after the TrollStore Helper is restored. 52 | 53 | *Note: There won’t be any visible changes on your device until it reboots.* 54 | 55 | ### Linux Users 56 | 57 | Install Dependencies 58 | 59 | 1. Open Terminal. 60 | 2. Go to the TrollRestore folder: 61 | ```bash 62 | cd ~/Downloads/TrollRestore_Linux 63 | ``` 64 | 3. Install required dependencies: 65 | ```bash 66 | pip3 install -r requirements.txt 67 | ``` 68 | 69 | ### How to Inject TrollStore Helper on Linux 70 | 71 | 1. Connect your iOS device to your computer. 72 | 2. In Terminal, run: 73 | ```bash 74 | python3 trollstore.py 75 | ``` 76 | 3. Enter the system app name to overwrite (e.g., Tips) and press Enter. 77 | 4. Your device will reboot when done. 78 | 79 | *Note: There won’t be any visible change until the reboot.* 80 | 81 | ## How to Install TrollStore Using TrollRestore on iOS 15.0 - 17.0 Devices 82 | 83 | After the TrollStore Helper has been injected: 84 | 85 | 1. Unlock your device and open the app you overwrote. 86 | 2. Tap "Install TrollStore" and wait for the device to respring. TrollStore will now be installed. 87 | 88 | ## Installing Persistence Helper in TrollStore 89 | 90 | For persistent installation: 91 | 92 | 1. Open the TrollStore app from your home screen. 93 | 2. Go to Settings and tap Install Persistence Helper. 94 | 3. Select the app (e.g., Tips) to set up the Persistence Helper. 95 | 96 | ## Post-Installation Tips for TrollRestore and TrollStore on iOS Devices 97 | 98 | - TrollRestore doesn’t restore a full persistence helper; it only replaces the main binary of a system app. 99 | - If you want to restore the chosen app to its original state, delete and reinstall it from the App Store. 100 | 101 | ## Computer Requirements for Installing TrollRestore on iOS 15.0 - 17.0 102 | 103 | For the precompiled builds: 104 | 105 | - **macOS:** Requires macOS 12 (Monterey) or higher. macOS 11 may work but is untested. 106 | - **Windows:** Requires Windows 10 or higher with iTunes installed. 107 | 108 | ## Credits 109 | 110 | - **JJTech:** Sparserestore (the main library used to restore the TrollHelper binary) 111 | - **Nathan:** Turning sparserestore into a TrollStore installer 112 | - **Mike, Dhinak G:** Various improvements to the installer 113 | - **doronz88:** pymobiledevice3 114 | - **opa334, Alfie:** TrollStore developers 115 | - **Aaronp613:** Minor improvements 116 | - **Contributors:** Thanks to everyone involved in making TrollRestore possible. 117 | 118 | This guide is provided for educational purposes only. It is intended to help users understand and learn about the TrollRestore installation method. 119 | --------------------------------------------------------------------------------