[Tutorial] Install Theos on Mac OS X for Jailbreak Development

Hi guys, Chris here and I thought I would create a follow-up blog post on how to install Theos but this time we will be installing it on your Mac OS X machine. There are a ton of perks to developing on a Mac machine rather than an iDevice for many different reasons and is the method in which I prefer! Before we get started we will need to download a few things:

  1. XCode 5.0 or newer (App Store)
  2. Homebrew
  3. iOS SDKs
  4. Header Files

Once we have both XCode and Homebrew installed, we will need to open up our Terminal window to install the latest Command Line Tools. To do this, simply type the following command into your active Terminal window:

xcode-select --install

A dialog should then appear. All you need to do now is click on Install and wait for the download and installation to complete. Once the installation has completed we will need to install dpkg and ldid using Homebrew which we downloaded previously. To do this, open up a new Terminal window and enter the following command:

brew install dpkg ldid

This should then download and install both packages. Once the packages have been installed, we can now install Theos to our desired directory. The most common directory, and the directory that I installed Theos in, would be ‘opt/theos’. What we will want to do is change our directory via Terminal to this directory. If you notice though, the opt folder is not visible so we need to run a command so we can view this folder. To do this, simply enter the following command into any active Terminal window:

sudo SetFile  -a  v  /opt

Once we have made our folder visible, we need to navigate to that folder via Terminal like so:

cd ../../opt

This will navigate backwards two directories to our root directory and then into the opt folder. Once we have navigated to this folder successfully, we need to run the following command to download Theos:

git clone --recursive https://github.com/theos/theos.git

This command will download and install Theos on our machine. Essentially, we are done at this point because Theos is installed but we will want to download the necessary files to start developing as well as setup some features to make it a little easier on us in the future!

The first thing we will want to do is edit our ‘~/.bash_profile‘ file. To do this, we need to run a Terminal command to allow us to open the file in TextEdit:

touch ~/.bash_profile; open ~/.bash_profile

Once the file has opened, add the following text to the end of the file:

export THEOS=/opt/theos
export PATH=$THEOS/bin:$PATH

The only thing you will need to change in the above text is the device IP address. You can find the IP address of your device by going into Settings > WiFi and then clicking on the (i) icon to the right of your network name.

At this point, we have successfully installed Theos but we will still need to download the header files needed for development as well as the target SDK we will be developing for. To download both, scroll to the top of the blog post and download the necessary files. Once they are downloaded we can now put them where we need them. To install the header files, copy all of the contents of the download into the following directory:


Now that we have installed the headers, we now need to install the SDK files. To do so, simply copy and paste the downloaded file into the following directory and unzip the file:


We should now be completely ready to start developing our first tweak! To check and see if we have successfully installed Theos, navigate to a directory we want to save our tweaks in and enter the following command:


If all was done correctly, you should now see a menu displaying options like so:

If you have any questions, please feel free to leave a comment below or contact me via one of the options listed on the Contact page of my website!

Leave a Reply

Your email address will not be published. Required fields are marked *