GStreamer multimedia framework
Find a file
Tim-Philipp Müller 7ea556d034 Configure subprojects in the right order
Use an array instead of a dict to make sure we iterate over
the list of subprojects in the right order, which is first
GStreamer core, then gst-plugins-base, then other things.

Without this subprojects might get configured in random order,
in which case gstreamer or gst-plugins-base libs might get picked
up via pkg-config if they are also available installed, instead of
being picked up from the subproject. This breaks all kinds of
assumptions in gst-build and will likely have strange effects
and/or lead to build failures such as

subprojects/gst-plugins-good/tests/check/meson.build:144:2:
ERROR: 'gstreamer-plugins-base-1.0' is not a pkgconfig dependency
2019-02-18 16:16:02 +00:00
cross-files Add example cross files 2018-12-11 15:47:07 +00:00
subprojects openh264.wrap: Update the upstream commit 2019-02-06 15:44:11 +05:30
.gitignore Add subprojects/libsoup/ to .gitignore 2019-02-08 16:25:29 +05:30
.gitlab-ci.yml Add Gitlab CI configuration 2018-11-09 18:54:03 +02:00
.gitmodules Remove meson/ submodule 2016-10-20 17:47:07 -03:00
checkout-branch-worktree scripts: Auto-detect whether we can enable colors 2019-02-05 17:23:49 +05:30
common.py scripts: Auto-detect whether we can enable colors 2019-02-05 17:23:49 +05:30
git-update scripts: Auto-detect whether we can enable colors 2019-02-05 17:23:49 +05:30
gst-uninstalled.py gst-uninstalled: Fix compatibility with meson 0.50 2019-02-14 14:01:52 +05:30
LICENSE Initial commit 2016-08-25 15:26:28 -03:00
meson.build Configure subprojects in the right order 2019-02-18 16:16:02 +00:00
meson_options.txt Add an orc wrap file for using orc subproject 2019-01-29 11:50:03 +09:00
msys2_setup.py msys2: Handle aliased functions when generating the .lib files 2017-09-25 14:15:09 -03:00
README.md README: Warn about not using the Meson MSI 2018-10-28 16:05:49 +00:00
setup.py Rename --no-error to --werror and flip default 2018-09-05 17:34:11 +05:30

gst-build

GStreamer meson based repositories aggregrator

You can build GStreamer and all its modules at once using meson and its subproject feature.

Getting started

Install meson and ninja

You should get meson through your package manager or using:

$ pip3 install --user meson

If you are building on Windows, do not use the Meson MSI installer since it is experimental and will likely not work.

You should get ninja using your package manager or download the official release and put it in your PATH.

Build GStreamer and its modules

You can get all GStreamer built running:

mkdir build/ && meson build && ninja -C build/

NOTE: on fedora (and maybe other distributions) replace ninja with ninja-build

Development environment

Uninstalled environment

gst-build also contains a special uninstalled target that lets you enter an uninstalled development environment where you will be able to work on GStreamer easily. You can get into that environment running:

ninja -C build/ uninstalled

If your operating system handles symlinks, built modules source code will be available at the root of gst-build/ for example GStreamer core will be in gstreamer/. Otherwise they will be present in subprojects/. You can simply hack in there and to rebuild you just need to rerun ninja -C build/.

NOTE: In the uninstalled environment, a fully usable prefix is also configured in gst-build/prefix where you can install any extra dependency/project.

Update git subprojects

We added a special update target to update subprojects (it uses git pull --rebase meaning you should always make sure the branches you work on are following the right upstream branch, you can set it with git branch --set-upstream-to origin/master if you are working on gst-build master branch).

Update all GStreamer modules and rebuild:

ninja -C build/ update

Update all GStreamer modules without rebuilding:

ninja -C build/ git-update

Custom subprojects

We also added a meson option, 'custom_subprojects', that allows the user to provide a comma-separated list of subprojects that should be built alongside the default ones.

To use it:

cd subprojects
git clone my_subproject
cd ../build
rm -rf * && meson .. -Dcustom_subprojects=my_subproject
ninja

Run tests

You can easily run the test of all the components:

meson test -C build

To list all available tests:

meson test -C build --list

To run all the tests of a specific component:

meson test -C build --suite gst-plugins-base

Or to run a specific test file:

meson test -C build/ --suite gstreamer gst_gstbuffer

Run a specific test from a specific test file:

GST_CHECKS=test_subbuffer meson test -C build/ --suite gstreamer gst_gstbuffer

Checkout another branch using worktrees

If you need to have several versions of GStreamer coexisting (eg. master and 1.14), you can use the checkout-branch-worktree script provided by gst-build. It allows you to create a new gst-build environment with new checkout of all the GStreamer modules as git worktrees.

For example to get a fresh checkout of gst-1.14 from a gst-build in master already built in a build directory you can simply run:

./checkout-branch-worktree ../gst-1.14 1.14 -C build/

Add information about GStreamer development environment in your prompt line

Bash prompt

We automatically handle bash and set $PS1 accordingly

Zsh prompt

In your .zshrc, you should add something like:

export PROMPT="$GST_ENV-$PROMPT"

Fish prompt

In your ~/.config/fish/functions/fish_prompt.fish, you should add something like this at the end of the fish_prompt function body:

if set -q GST_ENV
  echo -n -s (set_color -b blue white) "(" (basename "$GST_ENV") ")" (set_color normal) " "
end

Using powerline

In your powerline theme configuration file (by default in {POWERLINE INSTALLATION DIR}/config_files/themes/shell/default.json) you should add a new environment segment as follow:

{
  "function": "powerline.segments.common.env.environment",
  "args": { "variable": "GST_ENV" },
  "priority": 50
},