GStreamer In-Band Metadata for MPEG Transport Stream - Getting Started - Evaluating the project

From RidgeRun Developer Wiki


Previous: Getting Started Index Next: Getting Started/Getting the code





Overview

This page is a guide to testing the GStreamer In-Band Metadata evaluation binary provided by RidgeRun.


Requesting the Evaluation Binary

In order to request an evaluation binary for a specific architecture, please contact us providing the following information:

  • Platform
  • gst-launch-1.0 --gst-version
  • uname -a


Dependencies

This is the list of dependencies required to compile GStreamer.

sudo apt-get install \
pkg-config bison flex git \
libglib2.0-dev liborc-0.4-dev \
libtool autopoint autoconf \
gettext yasm

In case a requirement is not installed, please follow the instructions in the Building Guide to install dependencies.

Additional information at the Appendix.

Install the Evaluation Binaries

Extract the tarball provided by RidgeRun (note that the file names can change depending on the software version and target platform):

tar -xvf  gst-metadata-develop-gst-1.18-x86-0.1.0-eval

The evaluation files structure should be as follows (note that the file names can change depending on the software version and target platform):

gst-metadata-develop-gst-1.18-x86-0.1.0-eval
├── configuration.sh
├── environment.sh
├── README
└── usr
    └── lib
        └── x86_64-linux-gnu
            ├── gstreamer-1.0
            │   ├── libgstmeta.so
            │   ├── libgstmpegpsdemux.so
            │   ├── libgstmpegtsdemux.so
            │   └── libgstmpegtsmux.so
            ├── libgstbase-1.0.so.0 -> libgstbase-1.0.so.0.1806.0
            ├── libgstbase-1.0.so.0.1806.0
            ├── libgstcodecparsers-1.0.so.0 -> libgstcodecparsers-1.0.so.0.1806.0
            ├── libgstcodecparsers-1.0.so.0.1806.0
            ├── libgstmpegts-1.0.so.0 -> libgstmpegts-1.0.so.0.1806.0
            └── libgstmpegts-1.0.so.0.1806.0

Run the configuration script inside the extracted folder:

cd gst-metadata-develop-gst-1.18-x86-0.1.0-eval
./configuration.sh

Verify Installation

At this point, it should be possible to inspect the meta element:

Expected output:

Plugin Details:
  Name                     meta
  Description              Elements used to send and receive metadata
  Filename                 /home/ubuntu/gst-metadata-develop-gst-1.18-x86-0.1.0-eval/usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstmeta.so
  Version                  1.6.4
  License                  Proprietary
  Source module            gst-plugin-meta
  Binary package           RidgeRun elements
  Origin URL               http://www.ridgerun.com

  misbparser: MISB Parser
  metasink: Metadata Sink
  metasrc: Metadata Source

  3 features:
  +-- 3 elements

The plugin is ready to be used, Check the examples section to use the meta plugin.

Appendix

Building the alternative GStreamer environment

Here are the guides for installing a GStreamer environment.

GStreamer installation example on Ubuntu 16.04

Different GStreamer installation example for GStreamer version older than 1.20


Previous: Getting Started Index Next: Getting Started/Getting the code