openFrameworks addon fo intel Realsense2
Branch: master
Clone or download
Latest commit 9716b9b Dec 31, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
exampleLiveCamera refactoring Dec 30, 2018
examplePlayback add playback example Dec 30, 2018
libs/realsense2 add windows library files Dec 30, 2018
.appveyor.yml add ci scripts Aug 18, 2018
.travis.yml add ci scripts Aug 18, 2018 add screenshot, ci badges Dec 30, 2018 updare addon config Dec 30, 2018 add gitignore, addon_config, modify README Aug 9, 2018


Build Status Build status


This repos is openFrameworks addon for Intel® RealSense™ SDK 2.0. You can test your D400 series camera quickly. If you dont have device, you cann still playback BAG files and see how it works (for example performance, postprocessing, depth quality, etc)

Development period

  • 2018.7 ~ active


  • Realsense 2.14.1 (released on 2018.7, this is not latest)
  • libusb 1.0.22
  • openFrameworks 0.10.0, 0.10.1


  • OSX support
  • Windows support
  • Linux support
  • add ci scripts
  • add postprocessing example
  • add bag file playback example

Install Realsense SDK

Follow the official instalaction here and check you can launch realsense viewer.

Using oF Poroject Generator

This repo does not contain any project file. Please generate project file by yourself. Project Generator needs addon_config.make for setting library properly. This repo contain follwing two .make. Please rename your favorite one to addon_config.make.

  • addon_config_shared.make : Generate project file which use shared library(.dylib, .dll + .lib)
  • addon_config_static.make : Generate project file which use static library(.a, .lib).

Static library vs Shared library

osx + static lib (.a)

Realsense static lib for OSX is only avairable by compiling source code by yourself. But generated .a file is large over 180MB. So I dont put it in this repo. Please compile it by yourself(git LFS later maybe).

osx + shared lib (.dylib)

Shared lib is small enough (9.8MB) and you can find in this repo under /libs directory. Release version only. However because of osx app package system, you can not excute .app by double click when you use shared lib. You may need additional process to make standalone app. More details in this thread in oF forum.

Compile your own Realsense library

Compiling realsense library is straight forward.

  1. download zip source from Intel® RealSense™ SDK 2.0 github repo
  2. cmake (app or ccmake)
  3. set option (like BUILD_SHARED_LIBS) and generate project files
  4. build with Xcode or Visual Studio etc
  • please double check cmake's BUILD_WITH_OPENMP option is off since better performance without OpenMP. Please ask to google for details.

BAG file (rosbag)

With Realsense Viewer you can record/playback depth & color stream to bag file. SDK also support rec & playback. But recorded bag file is super big like 1GB for 10 sec. Please record your own bag file and put it in /examplePlayback/bin/data folder. (btw why it's so big? OpenNI's .oni file is way too small like 30MB for 10 sec).


  • Sometimes I experienced collapesed data stream when I use USB 3.0 extension cable from D435 camera. Unplug and plug camera again if you see strange data.
  • The quality of depth data from D400 series is depends on parameter of postprocessing. I recommend to check out this PDF article and test with Realsense Viewer.


libusb in osx

  • libusb is NOT included in this repo. Should be installed to your system with 'brew install libusb' at first SDK install step.