by bangnoise

bangnoise / ofxHapPlayer

A Hap player for OpenFrameworks

132 Stars 35 Forks Last release: almost 6 years ago (version2) Other 147 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


A Hap player for OpenFrameworks on macOS, Windows and Linux.

Hap is a codec for fast video playback. You can learn more about Hap, and find codecs for encoding, at the main Hap project.


This repo has branches for major OF versions. Use the branch which matches the version of OF you are using. The master branch matches the current OF release.

For example, if you want to use the addon with OpenFrameworks 0.9.x:

$ cd addons/ofxHapPlayer
$ git checkout OpenFrameworks-0.9

Linux Requirements

This step is only necessary on Linux. On macOS and Windows, the required libraries are bundled with the addon.

On Linux, ofxHapPlayer uses system libraries. For Ubuntu, the following packages are required:

libsnappy-dev, libswresample-dev, libavcodec-dev, libavformat-dev, libdispatch-dev

sudo apt-get install libsnappy-dev libswresample-dev libavcodec-dev libavformat-dev libdispatch-dev

Note that the Raspberry Pi does not support the compressed texture formats used by Hap, so you can't use this addon on a Raspberry Pi.

Pull-requests with instructions for other distributions are welcomed.


Use the OF Project Generator to generate build files for your project, selecting ofxHapPlayer as an addon.

#import "ofxHapPlayer.h"

ofxHapPlayer inherits from ofBaseVideoPlayer


When you want to draw:

player.draw(20, 20);

Note that there is no direct access to pixels and calls to getPixels() will return NULL.

Advanced Usage

You can access the texture directly:

ofTexture *texture = player.getTexture();

Note that if you access the texture directly for a Hap Q movie, you will need to use a shader when you draw:

ofShader *shader = player.getShader();
// the result of getShader() will be NULL if the movie is not Hap Q
if (shader)
if (shader)

Credits and License

ofxHapPlayer was written by Tom Butterworth, initially in April 2013, supported by Igloo Vision and James Sheridan. Since then it has been supported by Vidvox. It is released under a FreeBSD License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.