This is a guide and tutorial for installing openFrameworks, a C++ toolkit for creative coding.
- Clone openFrameworks from its GitHub repo
- Download and extract projectGenerator from the official release
- Test openFrameworks to make sure it works
Step 1: Install Dependencies - Xcode, command line tools, and wget
Download Xcode from the app store. Then, install Xcode’s command line tools with the following command.
If you do not already have Homebrew, install it.
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
wget using Homebrew.
brew install wget
Step 2: Clone the openFrameworks repo
Clone the master branch.
git clone --recursive firstname.lastname@example.org:openframeworks/openFrameworks.git && cd openFrameworks
Download external dependencies.
Step 3: Acquire the projectGenerator app
Move projectGenerator directory into the clone repository.
mv ~/Downloads/of_v0.10.1_osx_release/projectGenerator/ .
You may now delete the downloaded release directory and zip.
rm -r ~/Downloads/of_v0.10.1_osx_release*
Step 4: Compile all the example apps
Open the projectGenerator app.
- Enter the path to your openFrameworks directory. For me, the path is
- Press enter.
- Check the Advanced options box.
- Click the new tab that appears at the top named update multiple.
- Enter the full path to the examples directory into the Update Path field. For me, the path is
- Ensure that OS X (Xcode) is selected for the platform.
- Click the Update Multiple button and wait for several minutes. It took my Macbook Air about 15 minutes. There is no visual feedback until a success message appears.
Step 5: Test an example app
To ensure the installation worked correctly, open any example app in Xcode. To open 3DPrimitivesExample run the following command.
cmd + r or click the play button to build and run the app.
Step 6: Test a third-party app
For me, the real test is to confirm one of my own openFrameworks applications will run.
First, create and enter a directory to store your own apps.
mkdir apps/myApps && cd apps/myApps/
Second, clone an openFrameworks project.
git clone email@example.com:benwiz/ofSprinkles.git && cd ofSprinkles/ && git checkout 2d
Third, open the project.
Lastly, run the project.