Get Started with Intel® RealSense™ Camera ZR300

Get up and running quickly by taking advantage of our commands, tool downloads, and more.

Step 1: Unpack the Box

Included with the developer kit is the following:

  • Intel® RealSense™ Camera ZR300
  • USB 3.0 cable
  • Mounting plate
  • Safety and regulatory information

Step 2: Check the Operating System

For the Intel® Joule™ compute module, download and install Ubuntu* 16.04

For other devices (such as an Intel® NUC or AAEON UP* Board), download and install Ubuntu* 16.04 LTS Desktop

Please Note:
Other devices configurations are not fully validated by Intel and they may or may not function the same as the Intel® Joule™ compute module.

Step 3: Set the Time

The correct time must be set before following the instructions below. For instance, the Intel Joule module does not come supplied with a real-time-clock (RTC) battery, therefore you need to set the time manually before continuing installation. The steps below can also be used to automatically set the time from your internet connection.

Network Time Setup

$ sudo apt update
$ sudo apt install chrony ntpdate
$ sudo ntpdate

Manual Time Setup

$ sudo date -s "16:47 1/23/2017"

Step 4: Set Up the Repository

Add the Intel® RealSense™ software repository to the package manager on your Ubuntu* device’s so your device knows where to download additional software.

$ echo 'deb "" xenial main' | sudo tee /etc/apt/sources.list.d/realsense-latest.list
$ sudo apt-key adv --keyserver --recv-key D6FB2970
$ sudo apt update

Step 5: Install Intel® RealSense™ Camera Access Utilities

Get advance camera controls, such as contrast and exposure settings.

$ sudo apt install librealsense-utils
$ cpp-capture

This utility is for advanced users and includes additional camera controls, such as white balance. Once you have the utilities installed, you should be able to log meaningful events, synchronize multiple streams of images and motion samples, and measure the actual FPS (frames per second) in a specific period. Note that cpp-capture will preview live video from the ZR300 camera.

Step 6: Installing Runtime and Samples

This installation allows you to run all librealsense middleware samples.

$ sudo apt install librealsense-samples beignet-opencl-icd

Once you have the runtime installed, you should be able to see the camera output and run Intel® RealSense™ Middleware samples, such as person tracking, object library, and simultaneious localization and mapping (SLAM).

If your camera is plugged in when the runtime and samples are installed, you will need to unplug it and plug it back in to ensure all settings have been applied.


  • All samples installed to /usr/bin have ‘rs_’ prefix (for example, rs_slam_tutorial_1_gui)
  • Samples ending with 'gui' work with a keyboard and mouse connected locally to the device
  • Samples ending with 'web' start a built-in webserver, allowing you to connect remotely to the device from another computer
  • Samples without 'gui' or 'web' are console-only samples with very basic command line interface

Sample Details

Step 7: Install Development Tools

This step installs object recognition, person tracking, and SLAM libraries to your device.

$ sudo apt install librealsense-object-recognition-dev librealsense-persontracking-dev librealsense-slam-dev

Once you have installed the development tools, you can create your own application that interprets the output from the Intel® RealSense™ Middleware (object recognition, person tracking, SLAM).

The installation also installs tools for developers to create their own software, including samples and runtimes.

You can test whether the SDK is installed correctly by building samples from the source files on GitHub*.

$ sudo apt install build-essentials git cmake libjpeg-dev libopencv-dev
$ git clone
$ cd realsense_samples
$ mkdir build
$ cd build
$ cmake
$ make

After the compilation completes, all of the ‘realsense_samples’ will be in the folder you built and ready to run.

The following libraries are available:

  • librealsense-dev—A development file for the camera access library so developers can write their own software on top of librealsense (much like having an SDK to develop software)
  • librealsense-sdk0—Helpful utilities for use with the camera access library, such as record, playback, or projection.
  • librealsense-sdk-dev—Develop your software with functions such as record or playback in your application.
  • librealsense-object-recognition0—A runtime package of the Object Recognition samples.
  • librealsense-object-recognition-dev—Develop your own software with object recognition capabilities.
  • librealsense-persontracking0—A runtime package of the Person Tracking samples.
  • librealsense-persontracking-dev—Develop your own software on top of the person tracking software.
  • librealsense-slam2—A runtime package of the SLAM (simultaneous localization and mapping) samples.
  • librealsense-slam-dev—Develop your own software with SLAM capability.
Packages with "-dev" are development header files that you can install to develop your own software.
Packages with "0" or "2" (SLAM) are runtimes that you can install and see how each capability works.