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 of the commands shown in the following instructions are meant to be run as a normal user, not root. Similarly, Theos is 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).

  2. Run the installer:

     bash -c "$(curl -fsSL"


Third-party Toolchains

Some third-party toolchains have issues with Modules on macOS. In such cases, you can either try a different third-party toolchain (e.g., a newer or older version) or disable Modules for your project with XXX_USE_MODULES = 0.