A cross-platform build system for creating iOS, macOS, Linux, and Windows programs.

Installation instructions for iOS

This guide will help you install Theos on your jailbroken iOS device.

Platform Minimum OS version Targets supported
iOS 5.0 iOS

All the commands shown in the following instructions are meant to be run as the “mobile” user, not root. Similarly, Theos is also meant to be run as a normal user, not root.

  1. Install the following prerequisites:

  2. Set up the THEOS environment variable:


     echo "export THEOS=~/theos" >> ~/.profile


     echo "export THEOS=~/theos" >> ~/.zshenv

    For this change to take effect, you must restart your shell. Kill the terminal app in the taskswitcher then re-open the terminal app and do echo $THEOS on your shell to check if this is working.

  3. Clone Theos to your device:

     git clone --recursive $THEOS
  4. Get the toolchain:

    Theos Dependencies installs iOS Toolchain.

  5. Get an iOS SDK:

    You can get patched SDKs from our SDKs repo.

     curl -LO
     TMP=$(mktemp -d)
     unzip -d $TMP
     mv $TMP/sdks-master/*.sdk $THEOS/sdks
     rm -r $TMP
  6. Install the Swift toolchain (optional):

    Install swift if using Procursus, else install swift-toolchain from the BigBoss repo.

    Note that compiling Swift code requires a fairly modern SDK. It is recommended that you use the latest SDK that you can get.