We're hiring!
*

GStreamer on Windows: adding WebRTC support to a gst-build install

Aaron Boxer avatar

Aaron Boxer
January 28, 2021

Share this post:

Reading time:

Note: In September 2021, the GStreamer project merged all its git repositories into a single, unified repository, often called monorepo. The build system referred in this post as "gst-build" is now in the root of this combined/mono repository.

Earlier this week, WebRTC became an official W3C and IETF standard for enabling real time communication (RTC) between browsers and other mobile applications via a set of simple APIs. GStreamer has a powerful and rapidly maturing WebRTC implementation. So, the obvious question is: how do we build this on Windows?

There are two ways of building GStreamer on Windows - either with cerbero or gst-build. For a simple GStreamer install with WebRTC support, cerbero will just work out of the box. However, for a more flexible solution that builds significantly faster, we use gst-build. Unfortunately, it's not just a matter of using gst-build. You also need the OpenSSL dependency so that gst-build will build the WebRTC element.

Here's how to add this support:

OpenSSL

If you haven't already followed my previous guide on GStreamer and Windows, please follow the steps there to build GStreamer from source.

Next, we will need to clone and build OpenSSL

  1. Install 64 bit Strawberry Perl
  2. Delete Strawberry Perl path entries from system path
  3. Install 64 bit NASM
  4. Enter the NASM install directory on your Windows PATH
  5. git clone https://github.com/openssl/openssl.git
  6. Open 64 bit VS command shell as Administrator
  7. build OpenSSL using steps below (this could take a while). Note: we set c:/bin/OpenSSl as our OpenSSL install directory, but this is easily changed to the directory of your choice.
> cd openssl
> set PATH=%PATH%;C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin
> perl Configure VC-WIN64A --prefix=c:/bin/OpenSSL
> nmake
> nmake test
> nmake install

Now, download the OpenSSL pkg-config folder here and place it in the lib directory of your OpenSSL install directory.

Next, we need to add the OpenSSL install directory to the PKG_CONFIG_PATH environment variable that we set in my previous post:

Set PKG_CONFIG_PATH equal to %GSTREAMER_1_0_ROOT_X86_64%lib\pkgconfig;C:\bin\OpenSSL\lib\pkg-config

We also need to add the OpenSSL bin directory C:\bin\OpenSSL\bin to the Windows path.

And finally, we open a new 64 bit VS command shell and execute the following:

> cd %SOURCE_DIR%gst-build
> meson build --reconfigure --prefix=%GSTREAMER_1_0_ROOT_X86_64% -Dtls=disabled -Ddevtools=disabled && ninja -C build install

And now:

> gst-inspect-1.0 webrtcbin

should find the webrtcbin plugin!

If you have any questions about GStreamer WebRTC support on Windows or any other platform, please contact us!

Comments (6)

  1. Andrey:
    Apr 02, 2021 at 11:28 AM

    I wonder if prebuild OpenSSL from Github Releases will do. The build doesn't seem to be always easy:

    Microsoft (R) Program Maintenance Utility Version 14.28.29913.0
    Copyright (C) Microsoft Corporation. All rights reserved.

    "nasm" -Ox -f win64 -DNEAR -g -o crypto\bn\libcrypto-shlib-rsaz-avx512.obj "crypto\bn\rsaz-avx512.asm"
    crypto\bn\rsaz-avx512.asm:17: error: section alignment changed during code generation
    crypto\bn\rsaz-avx512.asm:436: error: section alignment changed during code generation
    crypto\bn\rsaz-avx512.asm:848: error: section alignment changed during code generation

    Reply to this comment

    Reply to this comment

  2. Andrey:
    Apr 02, 2021 at 11:39 AM

    Turned out to be necessary for successful OpenSSL build:

    git checkout OpenSSL_1_1_1-stable

    Reply to this comment

    Reply to this comment

    1. Aaron Boxer:
      Apr 02, 2021 at 04:56 PM

      Thanks, Andrey. Yes, you need to checkout out a stable release of OpenSSL. We
      will update the blog post to mention that.

      Reply to this comment

      Reply to this comment

  3. Andrey:
    Apr 03, 2021 at 02:51 PM

    These are getting built ok:
    - webrtcbin
    - gst-examples repo

    Binaries from gst-examples/webrtc are there but do not work though:

    Required gstreamer plugin 'vpx' not found
    Required gstreamer plugin 'dtls' not found
    Required gstreamer plugin 'srtp' not found

    I guess dtls and srtp need OpenSSL?

    A bit confused about this line:
    > meson build --reconfigure --prefix=%GSTREAMER_1_0_ROOT_X86_64% -Dtls=disabled -Ddevtools=disabled

    It should be -Dtls=enabled instead? Enabling makes glib-network unhappy at ninja build, though.

    Reply to this comment

    Reply to this comment

  4. Andrey:
    Apr 03, 2021 at 04:05 PM

    With dtls, installing pkg-config with msys2 and adding in to path helped.

    Reply to this comment

    Reply to this comment

  5. Aaron Boxer:
    Apr 07, 2021 at 05:01 PM

    Thanks, Andrey. My apologies for the confusion - were you able to build with dtls using pkg-config ?

    Reply to this comment

    Reply to this comment


Add a Comment






Allowed tags: <b><i><br>Add a new comment:


Search the newsroom

Latest Blog Posts

Re-converging control flow on NVIDIA GPUs - What went wrong, and how we fixed it

25/04/2024

While I managed to land support for two extensions, implementing control flow re-convergence in NVK did not go as planned. This is the story…

Automatic regression handling and reporting for the Linux Kernel

14/03/2024

In continuation with our series about Kernel Integration we'll go into more detail about how regression detection, processing, and tracking…

Almost a fully open-source boot chain for Rockchip's RK3588!

21/02/2024

Now included in our Debian images & available via our GitLab, you can build a complete, working BL31 (Boot Loader stage 3.1), and replace…

What's the latest with WirePlumber?

19/02/2024

Back in 2022, after a series of issues were found in its design, I made the call to rework some of WirePlumber's fundamentals in order to…

DRM-CI: A GitLab-CI pipeline for Linux kernel testing

08/02/2024

Continuing our Kernel Integration series, we're excited to introduce DRM-CI, a groundbreaking solution that enables developers to test their…

Persian Rug, Part 4 - The limitations of proxies

23/01/2024

This is the fourth and final part in a series on persian-rug, a Rust crate for interconnected objects. We've touched on the two big limitations:…

Open Since 2005 logo

We use cookies on this website to ensure that you get the best experience. By continuing to use this website you are consenting to the use of these cookies. To find out more please follow this link.

Collabora Ltd © 2005-2024. All rights reserved. Privacy Notice. Sitemap.