vimeo-depth-viewer - GitLite

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #linux #docker #macos #java #awesome #kubernetes #vue #awesome-list #ios #mcp #open-source

vimeo-depth-viewer

(★ 56)

OpenGL application for viewing depth and color video streams from Intel RealSense cameras

File Explorer

Download Latest Version (.zip)

- cover.png
- depthviewer.png
- image.png
- eigen
- glfw
- librealsense
- nanogui
- main.cpp
- MainWindow.cpp
- MainWindow.h
- MonitorWindow.cpp
- MonitorWindow.h
- VideoView.cpp
- VideoView.h
- VideoWindow.cpp
- VideoWindow.h
.gitignore
.gitmodules
CMakeLists.txt
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/vimeo/vimeo-depth-viewer

Downloads the entire project code from GitHub to your computer.

cd vimeo-depth-viewer

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.

brew install cmake

Installs the pre-built package via Homebrew — no source build required.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. CMake

Medium

Prerequisites

Git Needed to download the project code from GitHub.
CMake The tool used to generate build configuration.
C/C++ 컴파일러 Windows needs Visual Studio (Community edition, free), macOS needs Xcode Command Line Tools, Linux needs the gcc/g++ package.

brew install cmake

Installs the pre-built package via Homebrew — no source build required.

✅ Check that an executable was created inside the build folder, then run it directly (e.g. ./build/app_name).

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Vimeo Depth Viewer</h1>

<p align="center">
<img src="https://github.com/vimeo/depth-viewer/blob/master/docs/cover.png" alt="A GIF of the depth viewer application" height="400" />
</p>

<p align="center">
  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome">
</p>

<h4 align="center">An OpenGL application for viewing depth and color video streams from Intel RealSense cameras (D415/D435).</h4><p align="center">This repository consists of tools and demos presented at the Volumetric Filmmaking meetup at NYC.<br> Watch the <a href="https://vimeo.com/280815263#t=7836s">live-stream from the meetup</a> or checkout the <a href="https://github.com/vimeo/vimeo-depth-player/">WebVR examples</a>.</p>

<p align="center">Looking for a simpler solution that doesn't require code? <a href="https://docs.depthkit.tv/docs/the-depthkit-workflow">head over to Depthkit</a> to learn more, our WebVR examples fully support it</p>
 
1. [Quick-start](#quick-start)
1. [Features](#features)
1. [Build from source](#build-from-source)
1. [Dependencies](#dependencies)
1. [License](#license)

# Quick-start
Make you get either the Intel [RealSense D415/D435](https://click.intel.com/intelr-realsensetm-depth-camera-d415.html). We peronsally prefered working with the D415, as it proved more reliable, but both work with this software. To quickly get started, download a pre-built release of the depth-viewer [from here](https://github.com/vimeo/depth-viewer/releases) or [build it from source](#build-from-source). Once you have a binary launch it by double clicking it or calling `./VimeoDepthViewer` from the folder and you should be good to go.

# Features
- [x] An easy to use interface based on [nanogui](https://github.com/wjakob/nanogui).
- [x] Depth clipping for easy background removal.
- [x] Seprate stream view and monitor window for capturing and live streaming a full window using [OBS](http://obsproject.com)
- [x] Depth filtering (decimation, spatial and temporal filters)
- [x] Fully `git submodules` and `CMake` for easy set up

# Build from source
All 3rd party libraries used are included as `git submodules` to ease the setup and development process, it should be easy to clone using the `--recursive` flag and build everything from source.
1. Make sure you have `CMake` installed, for macOS, install [Homebrew](https://brew.sh) and run
```sh
brew install cmake
```
2. Clone the repository including all the submodules:
```
git clone https://github.com/vimeo/depth-viewer.git --recursive
```
3. Go inside the folder and create a build folder by running `cd vimeo-depth-viewer && mkdir build`
4. Run `CMake` by calling `cmake ../` from the build folder
5. Run `make` to build an executable
6. Run the executable by running `./VimeoDepthViewer`

> Tested on macOS v10.13.4 & CMake v3.11.4

# Dependencies
1. [GLFW](https://github.com/glfw/glfw)
1. [nanogui](https://github.com/wjakob/nanogui)
1. [Eigen](https://github.com/libigl/eigen)
1. [librealsense2](https://github.com/IntelRealSense/librealsense)

# License
License file could be [found here](https://github.com/vimeo/vimeo-depth-viewer/blob/master/LICENSE)

# Questions, help, and support
For questions and support, [ask on StackOverflow](https://stackoverflow.com/questions/ask/?tags=vimeo). If you found a bug, please file a [GitHub issue](https://github.com/vimeo/vimeo-depth-viewer/issues).

Make pull requests, file bug reports, and make feature requests via a [GitHub issue](https://github.com/vimeo/vimeo-depth-viewer/issues).