openFrameworks wrapper around the offscreen html renderer, Awesomium
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
example-opencv first commit Nov 6, 2013
src Use the *much* faster CopyTo method. Feb 21, 2015
.gitignore first commit Nov 6, 2013
LICENSE Initial commit Nov 6, 2013 add Windows instructions. Oct 22, 2015 Automatically add the SDK paths on Windows. Feb 27, 2015


Awesomium is an off-screen bHTML renderer. This basically means that you can give it a URL and it will give you an ofTexture of the webpage. You can also "inject" mouse and keyboard events, making it an interactive browser renderer. Also supports Flash!


  1. Download Awesomium Currently using v1.7.3
  2. Install Awesomium
  3. Try out the examples to make sure it works!

Using the Project Generator on OSX

It kind of sucks that there are so many steps required to add Awesomium to oF, but that's just the way it is right now. Essentially all you are doing is linking against the Awesomium framework and adding it to the application bundle under Executables. It's the same process covered in Setting Up on Mac OSX. If you don't know what that means, just follow the steps below.

  1. Generate a project using the Project generator. Make sure to check off ofxAwesomium in the addons list
  2. In the Finder, navigate to /Library/Frameworks (this is where the Awesomium installer put some stuff)
  3. Locate Awesomium.framework in /Library/Frameworks Locate Framework
  4. Drag the entire Awesomium.framework into XCode and drop it into the Project Navigator Drag and drop
  5. In the dialog that appears, click "Finish" Finish
  6. In the Project Navigator, click on the blue icon at the top. Then click on "Build Phases" Build Phases
  7. Drag "Awesomium.framework" from the Project Navigator and drop it on the section called "Link Binary With Libraries"
  8. In the Menu bar, go to Editor > Add Build Phase > Add Copy Files Build Phase
  9. In the resulting "Copy Files" build phase, change "Destination" to "Executables", and drag Awesomium.framework (again) from the Project Navigator to where it says "Add Files Here"

Using ProjectGenerator on Windows

The instructions for Windows are quite involved as well. Begin by opening the Windows installation instructions. You'll need them for several steps.

  1. Generate a project using the Project generator. Make sure to check off ofxAwesomium in the addons list
  2. Add your code or copy the example code into your project
  3. In the Set up your project section of the Windows installation instructions, follow steps 3-6 to add the necessary paths to your Visual Studios solution
  4. Follow the instructions in the Copy files to your build distribution section and copy the files into the project's bin folder
  5. Proceed to build your project