This document lists the tools and libraries needed for building and installing GIFT-Grab. Please note that only a small subset of all listed items is a required dependency. The majority of the listed items are needed only when a specific GIFT-Grab feature is activated.
GIFT-Grab has so far been tested only on Linux:
- Ubuntu 14.04 LTS, kernel: 3.19.0-59-generic
- Ubuntu 16.04 LTS, kernel: 4.4.0-72-generic (experimental: please see the known issues and limitations)
- Debian 9 (testing), kernel: 4.9.0-2-amd64 (only the reading, writing of video files, and NumPy / SciPy compatibility tested)
Building GIFT-Grab from source / installing GIFT-Grab via pip requires:
- A C++ compiler supporting C++11 (tested with GCC 4.9.3 on Ubuntu, 6.3.0 on Debian)
- CMake (tested with 3.2 on Ubuntu, 3.7.2 on Debian)
GIFT-Grab requires a subset of the following libraries based on activated features. Please see the relevant link below for how to activate GIFT-Grab features:
- Building GIFT-Grab from source (C++ and Python)
- Installing GIFT-Grab using
pip(only Python)
Please note that there are cross-dependencies between some of the optional dependencies. Check out the dependency installation guidelines for details.
The parantheses in the version column mean that the listed version has been tested only on the platform within the respective parantheses.
| Dependency | GIFT-Grab tested with version / model | Remarks |
|---|---|---|
| OpenCV | 2.4.12 (Ubuntu 14.04 LTS), 3.2.0 (Ubuntu 16.04 LTS) | |
| FFmpeg | 3.1.2 (Ubuntu), 3.2.4 (Debian 9 testing) | |
| NVENC (NVIDIA Video Codec SDK) | 6.0.1 | NVENC has a proprietary licence: enabling NVENC support makes GIFT-Grab undistributable. |
| A GPU supporting NVENC | GeForce GTX TITAN X and GeForce GTX 980 Ti | |
| kvazaar | 0.8.3 | |
| x265 | 1.9 | x265 is a GPL library: enabling x265 support upgrades the GIFT-Grab licence to GPL. |
| libvpx | 1.3.0 | |
| libVLC (VLC SDK) | 3.0.0 release candidate: nighly build ID: 20160913-0237 | Please see the note in the libVLC installation instructions about using libVLC for capturing network streams. |
| Epiphan Video Grabber SDK | 3.30.3.0007 | Epiphan Video Grabber SDK has a proprietary licence: enabling Epiphan Video Grabber SDK makes GIFT-Grab undistributable. |
| Blackmagic Desktop Video SDK | 10.11 | Blackmagic Desktop Video SDK has a proprietary licence: enabling support for Blackmagic cards makes GIFT-Grab undistributable. |
| Python | 2.7 | |
| Boost.Python | 1.54.0, and 1.63.0 beta 1 for NumPy support | |
| pkg-config | ||
| pytest | ||
| Catch | 1.5.8 | |
| zlib | ||
| POSIX threads (pthreads) |