GStreamer Tutorial

This repository contains GStreamer tutorial examples for C, C++, and Python. The examples' source files are originally from the official repository of the respective programming languages, and they are organized in subprojects to match the order of the "Tutorial" section in GStreamer's documentation.

• C: copied from the Gstreamer's repository - tutorials
• C++: modified from the examples in gstreamermm-1.10.
• Python: modified from the examples in the macthing version of gst-python source

Development Environment Setup

All codes are built and verified on Ubuntu 24.04 (22.04 should also work). Meson is used to build all the C and C++ codes.

GStreamer is built on top of the GObject and GLib. Refer to the GStreamer documentation for the installation guide to set up the C development environment.

Additional packages are required for C++.

$ sudo apt install \
    libglibmm-2.4-1v5 \
    libglibmm-2.4-dev \
    libgstreamermm-1.0-1 \
    libgstreamermm-1.0-dev

For Python, setup a working PyGObject environment, then install additional packages for GStreamer.

$ sudo apt install \
    python3-gst-1.0 \
    gir1.2-gstreamer-1.0 \
    gir1.2-gst-plugins-base-1.0 \
    gir1.2-gst-plugins-bad-1.0 \
    gir1.2-gst-rtsp-server-1.0

Build The Tutorial Examples

$ cd gst-tutorial
$ meson setup builddir
$ meson compile -v -C builddir

Clean up all the built binaries.

$ meson compile -v -C builddir --clean

Each subject of the tutorial is organized in the subprojects folder. Use the following example command to build a single tutorial target.

$ meson compile -v -C builddir basic03cpp