Metavision Viewer

This tool allows you to stream events from an event-based device or an event file (RAW, DAT or HDF5) and visualize them on a screen. It also demonstrates how to use Metavision SDK Driver API for visualizing events stream.

The source code of this tool can be found in <install-prefix>/share/metavision/sdk/driver/cpp_samples/metavision_viewer when installing Metavision SDK from installer or packages. For other deployment methods, check the page Path of Samples.


The related C++ code shows how to use Metavision SDK classes to record a RAW file as well as set and save bias parameters. To achieve the same operations with Python, you can refer to this link .

Expected Output

The tool visualizes events acquired from an event-based camera or an event file:

Expected Output from Metavision Viewer tool

How to start

You can directly execute pre-compiled binary installed with Metavision SDK or compile the source code as described in this tutorial.

To start the viewer based on the live stream from your camera, run:






If your camera is not detected and you get the error “Camera not found. Check that a camera is plugged into your system and retry”, please refer to our camera troubleshooting FAQ entry.

To start the viewer based on recorded data, provide the full path to a RAW, DAT or HDF5 file (here, we use a file from our Sample Recordings):


metavision_viewer -i traffic_monitoring.hdf5


metavision_viewer.exe -i traffic_monitoring.hdf5

To use the tool to record the live stream from your camera, use the -o option and provide the full path to an output RAW file:


metavision_viewer -o /path/to/my_record.raw


metavision_viewer.exe -o /path/to/my_record.raw

If you use this sample to record data, you should perform some checks and configuration to optimize the quality of the data you will collect. Please refer to the section Recording from live camera from Metavision Studio page where we mention camera installation, lighting conditions, focus adjustment and multiple camera settings.

In Metavision Viewer the camera settings (biases, ROI, Anti-Flicker etc.) can be given as an input using the command line option --input-camera-config (or -j). This option accepts JSON files described in the camera settings section. You can create such a JSON file using Studio, or pressing “s” while metavision_viewer is streaming from your camera. Then, you can update this file to use custom camera settings fitting your needs.

To check for additional options:


metavision_viewer -h


metavision_viewer.exe -h