ONE Jailbreak Ad

Install theos on macOS and iOS

Promotion image of Install theos on macOS and iOS article.

Theos began its journey as an iPhone framework, conceived to streamline code development for command line interfaces, particularly tailored for jailbroken iOS devices. It swiftly gained traction as one of the foremost libraries, facilitating the creation and compilation of a plethora of top-tier jailbreak tweaks, spanning both rootful and rootless configurations. Over time, Theos transitioned into a versatile Make-based build system for desktop platforms, such as Windows, Linux, and macOS.

A substantial portion of the jailbreak community relies on open-source jailbreak tweaks, which function not only as inspirational demonstrations of the potential for modifying the iOS system but also as expansive knowledge repositories for budding tweak developers. Many of these tweaks necessitate the utilization of Theos libraries for compiling jailbreak tweaks.

The Theos libraries are conveniently installable across various platforms, including iOS devices, macOS, Linux, and Windows PCs. This versatility enables developers to compile tweaks seamlessly on a diverse range of operating systems. In this guide, we will walk you through the step-by-step process of installing Theos libraries specifically on macOS and iOS platforms.

In the upcoming article, I'll walk you through the process of compiling an example open-source tweak, designed to support both rootless and rootful jailbreak environments, available on GitHub. Alongside, I'll pinpoint common mistakes that might hinder the smooth compilation of the tweak. However, before we embark on that journey, let's start by installing Theos.

How to install theos on macOS

This guide is designed to assist you in installing Theos on your macOS device. To proceed with the installation, your macOS system should be running Mavericks (10.9) or later, up to the latest Sonoma 14 operating system. The most recent version of Theos for macOS can compile packages for macOS, iOS, watchOS, tvOS, as well as simulators.

Follow those steps to install theos on macOS Sonoma 14:

Step 1. Open the terminal app and install Install Homebrew Package Manager for macOS.

/bin/bash -c "$(curl -fsSL"

Step 2. Install additional brew components required to compile files, modify a binary's entitlements, manage git repositories, and extract archives.

brew install ldid xz
brew install git
brew install make

echo PATH=\"$(brew --prefix make)/libexec/gnubin:\$PATH\" >> ~/.zprofile

For versions of macOS earlier than 10.15 Catalina, the default shell is bash rather than zsh. As such, you’ll want to use ~/.bash_profile instead of ~/.zprofile in the command above.

Step 3. Install Xcode from the App Store, which includes essential toolchains for all Apple platforms. Please be aware that the latest version of Xcode includes the latest SDK of iOS.

Step 4. Run theos installer for macOS from the terminal app.

 bash -c "$(curl -fsSL"

Screenshot of theos installer running in terminal app on macOS.

Step 5. Set up the THEOS environment variable.

export THEOS=~/theos

echo "export THEOS=~/theos" >> ~/.zprofile
chmod 755 ~/.zprofile

Step 6. Downloading patched iOS SDKs required for tweak compilation.

curl -LO

Step 7. Extract the patched SDKs archive to a TMP folder. Create it if doesn't exist.

unzip -d TMP/

Step 8. Move all patched SDKs to theos skds folder.

mv TMP/sdks-master/*.sdk $THEOS/sdks

Screenshot of patched SDKs list in Finder.

Step 9. Remove the file and the TMP folder.

rm -r TMP/

Step 10. Occasionally, you should update Theos. This can be done with the following command.


How to install theos on iOS

This comprehensive guide is designed to assist you in successfully installing Theos on your iOS device. By following the steps outlined below, you will be able to seamlessly run Theos on iOS 12.0 or later. Whether you're operating in a rootless or rootful jailbreak environment, rest assured that both configurations are fully supported. Let's get started!

Step 1. Jailbreak your device with a preferred tool.

Step 2. Add required repositories to your package manager like Sileo.

Step 3. Install packages (bash, curl, sudo) with your package manager or from the terminal app.

apt-get install bash curl sudo

Step 4. Open the terminal app and install theos for iOS.

bash -c "$(curl -fsSL"
Author Photo
Written by

Kuba has over 20 years of experience in journalism, focusing on jailbreak since 2012. He has interviewed professionals from various companies. Besides journalism, Kuba specializes in video editing and drone flying. He studied IT at university before his writing career.

Post a comment

Latest Posts


How to use Palen1x ISO to jailbreak on Windows

Palera1n Jailbreak for iOS 15 to iOS 16 is not available for Windows PC, which has led to the development of a new project called Palen1x. The goal of Palen1x is to enable Windows users to access Palera1n directly from their PCs. Palen1x is based on the...

Euro 2024 playlist for StrymTV

Euro 2024 playlist for StrymTV

If you love football, get ready for Euro 2024 in Germany. It’s a big event featuring top European players like Cristiano Ronaldo, Robert Lewandowski, and Kylian Mbappe. With StrymTV you can watch all the Euro 2024 group stage games on your mobile device...


Detect SeaShell malware in IPA and TIPA with TrollInstall

TrollInstall is a shortcut app that lets you install IPA and TIPA files with SeaShell protection. SeaShell is an open-source malware that can easily be injected into any IPA file installed through TrollStore. Downloading IPAs from untrusted sources can...