roothide/bootstrap

A full featured bootstrap for iOS 15.0-17.0 A8-A17 & M1+M2 using roothide

roothide Bootstrap

A full featured bootstrap for iOS 15.0-17.0 A8-A17 & M1+M2 using roothide.

WARNING: By using this software, you take full responsibility for what you do with it. Any unofficial modifications to your device may cause irreparable damage. Refer to the FAQ linked in the Usage section for safe usage of this software.

roothide Bootstrap is available to download on this repositories Releases.

Building

If you do not have access to MacOS, refer to the FAQ in the Usage section to build with GitHub Actions instead.

You'll need MacOS to build, as you require Xcode from the App Store. Simply having Xcode Command Line Tools is insufficient. Here's how to build the Bootstrap:

1. Update/Install Theos with roothide support

   bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"
   

   If you encounter errors from a previous Theos installation, remove Theos in its entirety before continuing.

2. Clone the GitHub repository and enter directory

   git clone https://github.com/roothide/Bootstrap/ && cd Bootstrap
   

3. Build Bootstrap.tipa

   make package
   

4. Transfer Bootstrap.tipa from ./packages/ to your device and install it with TrollStore

Usage

The roothide Bootstrap application must be installed with TrollStore. Use version 2.0.9 or later for enabling developer mode on-device.

Tweaks not compiled or converted to roothide will not work out-of-the-box with roothide Bootstrap. Refer to the FAQ below on how to use roothide Patcher.

By design, roothide does not inject tweaks into any applications by default. To enable tweak injection into an application, press App List in the Bootstrap app, and enable the toggle of the application you want to inject into. Injection into com.apple.springboard or daemons is not possible with the roothide Bootstrap. Refer to the FAQ below on injection into com.apple.springboard.

A roothide Bootstrap FAQ is available here.

Develop tweaks

Both rootful and rootless tweaks aren't out-of-the-box compatible with roothide, so you'll need to develop them specifically to support it. You can refer to the developer documentation here.

Discord server

You can join the roothide Discord server for support or general discussion here.

The "Our Table" Icon

The ProcursusTeam logo was originally made by @TheAlphaStream, and later edited by @sourcelocation.

Credits

Huge thanks to these people, we couldn't have completed this project without their help!

• absidue: https://github.com/absidue
• akusio: https://twitter.com/akusio_rr
• Alfie: https://alfiecg.uk
• Amy While: http://github.com/elihwyma
• Barron: https://tweaksdev22.github.io
• BomberFish: https://twitter.com/bomberfish77
• bswbw: https://twitter.com/bswbw
• Capt Inc: http://github.com/captinc
• CKatri: https://procursus.social/@cameron
• Clarity: http://github.com/TheRealClarity
• Cryptic: http://github.com/Cryptiiiic
• dxcool223x: https://twitter.com/dxcool223x
• Dhinakg: http://github.com/dhinakg
• DuyKhanhTran: https://twitter.com/TranKha50277352
• dleovl: https://github.com/dleovl
• Elias Sfeir: https://twitter.com/eliassfeir1
• Ellie: https://twitter.com/elliessurviving
• EquationGroups: https://twitter.com/equationgroups
• Évelyne: http://github.com/evelyneee
• GeoSnOw: https://twitter.com/fce365
• G3n3sis: https://twitter.com/G3nNuk_e
• hayden: https://procursus.social/@hayden
• Huy Nguyen: https://twitter.com/little_34306
• iAdam1n: https://twitter.com/iAdam1n
• iarrays: https://iarrays.com
• iDownloadBlog: https://twitter.com/idownloadblog
• iExmo: https://twitter.com/iexmojailbreak
• iRaMzi: https://twitter.com/iramzi7
• Jonathan: https://twitter.com/jontelang
• Kevin: https://github.com/iodes
• kirb: http://github.com/kirb
• laileld: https://twitter.com/h_h_x_t
• Leptos: https://github.com/leptos-null
• limneos: https://twitter.com/limneos
• Lightmann: https://github.com/L1ghtmann
• Linus Henze: http://github.com/LinusHenze
• MasterMike: https://ios.cfw.guide
• Misty: https://twitter.com/miscmisty
• Muirey03: https://twitter.com/Muirey03
• Nathan: https://github.com/verygenericname
• Nebula: https://itsnebula.net
• niceios: https://twitter.com/niceios
• Nightwind: https://twitter.com/NightwindDev
• Nick Chan: https://nickchan.lol
• nzhaonan: https://twitter.com/nzhaonan
• Oliver Tzeng: https://github.com/olivertzeng
• omrkujman: https://twitter.com/omrkujman
• opa334: http://github.com/opa334
• onejailbreak: https://twitter.com/onejailbreak_
• Phuc Do: https://twitter.com/dobabaophuc
• PoomSmart: https://twitter.com/poomsmart
• ProcursusTeam: https://procursus.social/@team
• roothide: http://github.com/roothide
• Sam Bingner: http://github.com/sbingner
• Shadow-: http://iosjb.top/
• Snail: https://twitter.com/somnusix
• SquidGesture: https://twitter.com/lclrc
• sourcelocation: http://github.com/sourcelocation
• SeanIsTethered: http://github.com/jailbreakmerebooted
• TheosTeam: https://theos.dev
• tigisoftware: https://twitter.com/tigisoftware
• tihmstar: https://twitter.com/tihmstar
• xina520: https://twitter.com/xina520
• xybp888: https://twitter.com/xybp888
• xsf1re: https://twitter.com/xsf1re
• yandevelop: https://twitter.com/yandevelop
• YourRepo: https://twitter.com/yourepo
• And you, the community, for giving insightful feedback and support.

bootstrap's Issues

OneSettings crashes settings app after scrolling anywhere beneath Game Center

Hello, I want to use OneSettings with the RootHide Bootstrap but trying to scroll anywhere beneath the “Game Center” settings button will instantly crash the app.

com.apple.shortcuts crashes on launch when enabled in App List

Title. Disabling it makes it work again.

Stuck on Finalizing Bootstrap

OS: iOS 17.0
Model: iPhone 14 Pro
Region: Korea

I can't install Bootstrap as it always gets stuck at Finalizing Bootstrap step!
Is this a known issue?

Jailbreak Detection Megaissue

This issue can be used to list off apps that have jailbreak detection advanced enough to detect WITHOUT injection with AppEnabler or even after uninstalling the bootstrap and removing /private/var/jb and /private/var/containers/Bundle/Application/.jbroot-$(jbrand)/ along with application data removal.

It's not necessarily helpful to link to tweaks which may bypass anything in here since this is an issue on the Bootstrap repo itself, but can narrow it down.

Before commenting, please ensure you 100% do not have anything visible like Filza's URL scheme (Remove Filza from TrollStore and install the no URL scheme version) and any other jailbreak application that may expose their URL scheme. Also, ensure your results aren't stored anywhere by clearing application data by uninstalling and reinstalling the application, assuming the results are stored there.

DLEasy incompatibility

Hi, I was trying to install DLEasy on bootstrap iOS 17 but I have the next issue, if you may help

Thanks

Code (255) after status: Rebuilding apps

I am on ios 16.1.2 (iphone 13 pro)

after i click bootstrap it goes through everything exept the last step it gives me an code 255 and does nothing.

Sileo and zebra work but i cannot get into AppEnabler. (Also Serotonin does not work anymore.)

i tried rebooting,force rebooting reinstalling Bootstrap upgrading from 4.1 to 4.2 nothing worked.

Cask 3 settings do not save

Hey there, I’m trying to use the bootstrap with the “Cask 3” tweak but it seems like changing the settings for this tweak refuse to save.

Offloading apps

Constant offloading of any apps that are enabled through bootstrap, sometimes to the point the apps are unusable.

RootHide Manager doesn't wanna open

iOS: 16.1, iPhone 13

trim.48BE76C0-D9C1-40B7-BCDF-E73B80D32797.MOV

GitHub

“Developer Mode not enabled” when it is

Battery usage cannot be loaded when com.apple.Preferences is enabled in App List

After enabling the tweak, the configured battery settings fail to load properly

Doesn’t work iPhone 12 iOS 15.6

Doesn’t work on iOS 15.6 and it says wait for fix so is the issue found already?

How to update 3.1 to 4.1?

Do I just need to new ipa replace the old version with it?

Bootstrap Beta 2 - Developer Mode Issue!

After extracted the iPA file from the source code, and installed the Bootstrap using TrollStore2, i'm still not able to JB my iPhone because the app doesn't check the Developer Mode is already Enabled correctly

Info:
iPhone XS Max, iOS 16.4.1

Daemons don't function properly

Daemons such as cranehelperd (Crane) and nfcd (Aemulo) either don't function properly, or tweaks are unable to access them. This prevents tweaks like Crane and Aemulo from functioning properly. I believe this is also why iCleaner crashes on boot, as iCleaner has a lot to do with daemons too.

Apps injected with bootstrap may encounter URL exceptions.

Apps injected with bootstrap may encounter URL exceptions.For example, clicking on the personal hotspot prompt on Lingdong Island will redirect him to the injected app. But not every app will do this. Using QQ testing, this issue can be reproduced.

Injecting Apple Music disconnects it from network

Title

.github/workflows/build.yml

name: Build and Package

on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
workflow_dispatch:

jobs:
build:
name: Build Bootstrap
runs-on: macos-latest

steps:
  - name: Checkout
    uses: actions/checkout@v3
    with:
      submodules: true

  - name: Install Theos
    run: bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"

  - name: Setup Environment
    run: echo "THEOS=~/theos" >> $GITHUB_ENV

  - name: Make Bootstrap Package
    run: make package

  - name: Upload Artifact
    uses: actions/upload-artifact@v3
    with:
      name: Bootstrap.tipa
      path: ./packages/Bootstrap.tipa

update-release:
name: Release .tipa
runs-on: ubuntu-latest
needs: build

steps:
- name: Delete old release
  uses: dev-drprasad/[email protected]
  with:
    delete_release: true
    tag_name: release
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Get artifacts
  uses: actions/download-artifact@v3
  with:
    name: Bootstrap.tipa
- name: Create new release
  uses: ncipollo/release-action@v1
  with:
    name: Rolling Release
    body: These are automatically updated builds of the latest commit.
    artifacts: "Bootstrap.tipa"
    tag: release
    token: ${{ secrets.GITHUB_TOKEN }}

fork

Finalizing Bootstrap | prep_bootstrap.sh hangs

iOS 17.0 with TrollStore, iPhone 14 Pro

line 208 of bootstrap.m calls a shell script called prep_bootstrap.sh. In earlier versions it returned with error 255 but now seems to just hang. This is the finalizing bootstrap error. Lmk if you guys find anything! I will debug once I’m home in 2024

Orion Runtime Refuses to install on ios 17

Both sileo and zebra throw a "depends firmware" error when trying to install Orion on ios 17. I'm using the version from the root hide repo. (Only on ios 17, on ios 16 it installs.)

iOS 15.6 iPhone 12 Stock Apps crash

Whenever I try to inject tweaks into Music/Settings the app will crash at start i've tried restarting rebuilding apps in both bootstrap and in trollstore to no avail.

deleted every sileo tweak and aint working no more

i really thought bro ‼️

future addition (?): uicache rootfs system apps after uninstalling bootstrap

If tweaks are injected into a rootfs system app (e.g. settings/preferences.app), it will be uicached in the bootstrap (/var/containers/Bundle/Application/.jbroot-xxxxxxx/Applications), upon uninstalling the bootstrap this will be removed without uicaching in /Applications (rootfs), so the bootstrap should reuicache /Applications after uninstalling the bootstrap

'You have installed an old beta version'

Photo: https://cdn.discordapp.com/attachments/1153426136802529280/1192018809956089936/image0.jpg

You may need to completely uninstall your bootstrap within the application to be able to install newer commits of the bootstrap, even for updates like beta 2 -> beta 3.1. There is currently no known fix. Uninstalling the bootstrap is not possible in the new version, install the version you previously had your bootstrap on to uninstall.

code(255) stderr: when enabling applications in AppEnabler

code255
其他app都正常

Where the tweaks

There is no tweak settings in the settings app…

Unable to uninstall on iPhone 7

The uninstall button is offscreen and there is no way to scroll down.

There should be a problem with the application's network permissions.

If Chinese devices do not open a VPN, Sileo Zebra, etc. cannot access the network. They must use a VPN to have network access rights. Installing the network repair plug-in has no effect, the device is iPhone 12 pro max, iOS version 17.0

Can edit system file and keychain-2.db?

Hello. Can you answer it for me?

• How to edit system plist file
• Delete and edit table in /var/KeyChains/keychain-2.db
  Thanks you!!

After restarting, Using the injected app 's widget will be blank

Using the injected app, after restarting, you need to switch on and off the injection button once to display the content of the widget again, otherwise it will be blank

has it been tested on M1 17.0?

I built Bootstrap.tipa and installed it through TrollStore 2 on my iPad 12.9 M1 running iOS 17.0. However, I encountered a problem where attempting to open Bootstrap results in an immediate crash of Bootstrap.

Could you please confirm if Bootstrap has been tested and is expected to work with iPad 12.9 M1 on iOS 17.0? Additionally, if there are any known issues or troubleshooting steps, I would appreciate any guidance you can provide. Should I change the constants in the Makefile as per my device or use the default ones?

Sorry I did not find a discussion section so asking my query by creating an issue.

Unable to install enabled apps to Apple Watch

Installing the app from App Store on Apple Watch disables tweak injection to the app

13promax iOS17.0 The latest progress of repair？

13/14 17.0 When will it be repaired?

Inconsistent crashes in com.apple.Preferences

Stated in the Discord, some people are experiencing crashes related to com.apple.Preferences when installing PreferenceLoader. TweakSettings by CreatureSurvive can be used as an alternative for these people, but it's good to address the issue directly. Even on clean Bootstrap installs, some people are unable to use Settings as a tweak preference changer, and must rely on TweakSettings, while some people are the complete opposite, with both working for some people.

Battery drain & notifications issues

Either bootstrap or serotonin is causing a massive battery drain

Using app enabler stops notifications showing up in the notification settings and stops notification coming through for those apps

M2/16.5 error code 255

everything not work after this

install->code255->reboot->bootstrap
install->code255->reboot->uninstall->reboot->install
this also not worked :(
device:ipad 14,3 (ipad pro 11in 4th)
ios version: ipados 16.5(20F66)

Sorry

iOS-native shortcuts app integration

Suggestion; I'm thinking of an idea where, when Serotonin is launched, the bootstrap is automatically ran. It's moreso a convenience thing, but it'd be pretty useful.

Enabling tweak injection breaks application permissions

After respring, the mobile app cannot receive push notifications, and the app cannot be found in the settings

disable tweak and re-able tweek enabler , app can receive push notifications

Make package failing

When i try to make Bootstrap following the provided instructions. The building process fails with the following error

> Making all for xcodeproj Bootstrap… bash: -project: command not found make[2]: *** [internal-xcodeproj-compile] Error 1 make[1]: *** [internal-xcodeproj-all_] Error 2 make: *** [Bootstrap.all.xcodeproj.variables] Error 2

Stock Apps Crash when Settings Preferences is on from the App Enabler in Bootstrap 4.2

Stock Apps Crash when Settings Preferences is on from the App Enabler in Bootstrap 4.2

When I open Settings from the bootstrap AppEnabler the Settings app dont open along with all the other stock apps like Mail, Notes, Reminders, Safari etc.

iPhone 14 Pro, 16.3.1, Bootstrap Beta 4.2.

I will share logs for Settings app.
Settings crash text.txt

Repo returning 404 error

When trying to install the Patcher the https://roothide.github.io/procursus/ repo returns a 404 error making it impossible to install the dependencies.

Trollstore and I downloaded apps from it doesnt work when I pressed uninstall and rebuilds apps in bootstrap oh and also apps I injected tweaks

Ipad 8
iOS 16.1.1
Any solution?

No URL Scheme for Sileo & Zebra

Sileo & Zebra have no URL scheme, not sure if this is on purpose or not.

The "get"button freezes selio when pressing it after installing the first package installed

Cannot place calls while com.apple.InCallService is enabled in App List

I have some tweaks installed and working, when I active InCallService on bootstrap, I can’t make calls with the phone app.
I was trying AudioRecorder, I thought that was the problem but I uninstalled it and the issue persist, so I de activate InCallService on bootstrap, and know works.

Can I inject tweaks on InCallService?

inject dont work

After i did install xinamine i tried to add smplinks, it was working but after i delete it i got an error. i didnt took a look on it.
then i went to settings i saw that twaek injeciton stop to work. Treid var clean/ uninstall bootstrap etc, didnt help me to fix it.

FIXED !!!

          FIXED !!!

iPhone 14 Pro Max - IOS 16.4.1

Originally posted by @B1N0Lee in #17 (comment)