install roothide/theos
bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"
and it's always automatically synchronized and maintains 100% compatibility with the original theos.
Build package for roothide
for those simple tweaks that don't use the file api to access jailbreak files, just
make package with THEOS_PACKAGE_SCHEME=roothide
Using roothide APIs if you need to use the file apis to access jailbreak files in source code
#include <roothide.h>
//then using roothide api to access jailbreak files
const char* c_path = jbroot("/path/to/jb/file");
NSString* objc_path = jbroot(@"/path/to/jb/file");
std::string cpp_path = jbroot(std::string("/path/to/jb/file"));
the jbroot API can be used in C/C++/Objective-C/Swift and its fully compatible with building rootful/rootless package
In Swift project, it's better to use a swift bridging header file for #include <roothide.h> instead of using import roothide in swift source files. this will ensure your project is compatible with building rootful/rootless, ref to https://theos.dev/docs/swift#:~:text=Objective%2DC%20to%20Swift
Add these entitlements to your executable/app to make them work correctly with roothide:
<key>platform-application</key>
<true/>
<key>com.apple.private.security.no-sandbox</key>
<true/>
<key>com.apple.private.security.storage.AppBundles</key>
<true/>
<key>com.apple.private.security.storage.AppDataContainers</key>
<true/>
If you want to build your project with Xcode instead of theos,
here is the roothide sdk: devkit.zip
roothide/theos is now compatible with building roothide packages from existing tweak projects that use rootless path macros, there is a warning message to ensure you have read this document and you can define the DISABLE_ROOTLESS_COMPAT_WARNING macro to silence the message.
For more details about roothide, please refer to
roothideDev: https://twitter.com/roothideDev
roothide/theos-dev: https://discord.gg/qaCFxr33CV
roothide discord server: https://discord.gg/ZvY2Yjw8GA
theos dev discord server: https://discord.gg/z4RTnrcbKW
9 followers · starred Oct 2023
108 followers · starred Apr 2026
15 followers · starred Oct 2025
Objective-C
100.0%
install roothide/theos
bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"
and it's always automatically synchronized and maintains 100% compatibility with the original theos.
Build package for roothide
for those simple tweaks that don't use the file api to access jailbreak files, just
make package with THEOS_PACKAGE_SCHEME=roothide
Using roothide APIs if you need to use the file apis to access jailbreak files in source code
#include <roothide.h>
//then using roothide api to access jailbreak files
const char* c_path = jbroot("/path/to/jb/file");
NSString* objc_path = jbroot(@"/path/to/jb/file");
std::string cpp_path = jbroot(std::string("/path/to/jb/file"));
the jbroot API can be used in C/C++/Objective-C/Swift and its fully compatible with building rootful/rootless package
In Swift project, it's better to use a swift bridging header file for #include <roothide.h> instead of using import roothide in swift source files. this will ensure your project is compatible with building rootful/rootless, ref to https://theos.dev/docs/swift#:~:text=Objective%2DC%20to%20Swift
Add these entitlements to your executable/app to make them work correctly with roothide:
<key>platform-application</key>
<true/>
<key>com.apple.private.security.no-sandbox</key>
<true/>
<key>com.apple.private.security.storage.AppBundles</key>
<true/>
<key>com.apple.private.security.storage.AppDataContainers</key>
<true/>
If you want to build your project with Xcode instead of theos,
here is the roothide sdk: devkit.zip
roothide/theos is now compatible with building roothide packages from existing tweak projects that use rootless path macros, there is a warning message to ensure you have read this document and you can define the DISABLE_ROOTLESS_COMPAT_WARNING macro to silence the message.
For more details about roothide, please refer to
roothideDev: https://twitter.com/roothideDev
roothide/theos-dev: https://discord.gg/qaCFxr33CV
roothide discord server: https://discord.gg/ZvY2Yjw8GA
theos dev discord server: https://discord.gg/z4RTnrcbKW
9 followers · starred Oct 2023
108 followers · starred Apr 2026
15 followers · starred Oct 2025
Objective-C
100.0%