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

Installation instructions for macOS

This guide will help you install Theos on your macOS device.

Platform Minimum OS version Targets supported
macOS Mavericks (10.9) macOS, iOS, watchOS, tvOS, and simulators

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

  1. Install the following prerequisites:

    • Homebrew
    • Xcode1 is mandatory. The Command Line Tools package isn’t sufficient for Theos to work. Xcode includes toolchains for all Apple platforms.

    1 Xcode 5.0 or newer. Xcode 4.4 supported, but only when building for ARMv6 (1st/2nd generation iPhone/iPod touch).

     brew install ldid xz
  2. Set up the THEOS environment variable:

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

    If you are using macOS 10.14 or older, change ~/.zprofile to ~/.profile. The default shell was changed from bash to zsh in macOS 10.15. You can check which one you are using by running echo $SHELL.

    For this change to take effect, you must restart your shell. Open a new tab 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:

    Xcode contains the toolchain.

  5. Get an iOS SDK:

    Xcode always provides the latest iOS SDK, but as of Xcode 7.3, it no longer includes private frameworks you can link against. This may be an issue when developing tweaks. 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