From 0f859b90299ad042c593fbeb0d38c7b6ddbdd292 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= Date: Mon, 23 Jan 2023 11:58:41 +0200 Subject: [PATCH] Get README.md in sync again Fixes https://gitlab.freedesktop.org/gstreamer/gstreamer-rs/-/issues/437 --- gstreamer-allocators/README.md | 73 +++++++++++++-------- gstreamer-app/README.md | 73 +++++++++++++-------- gstreamer-audio/README.md | 73 +++++++++++++-------- gstreamer-base/README.md | 73 +++++++++++++-------- gstreamer-check/README.md | 73 +++++++++++++-------- gstreamer-controller/README.md | 73 +++++++++++++-------- gstreamer-editing-services/README.md | 73 +++++++++++++-------- gstreamer-gl/README.md | 73 +++++++++++++-------- gstreamer-gl/egl/README.md | 73 +++++++++++++-------- gstreamer-gl/wayland/README.md | 73 +++++++++++++-------- gstreamer-gl/x11/README.md | 73 +++++++++++++-------- gstreamer-mpegts/README.md | 73 +++++++++++++-------- gstreamer-net/README.md | 73 +++++++++++++-------- gstreamer-pbutils/README.md | 73 +++++++++++++-------- gstreamer-play/README.md | 73 +++++++++++++-------- gstreamer-player/README.md | 73 +++++++++++++-------- gstreamer-rtp/README.md | 73 +++++++++++++-------- gstreamer-rtsp-server/README.md | 73 +++++++++++++-------- gstreamer-rtsp/README.md | 73 +++++++++++++-------- gstreamer-sdp/README.md | 73 +++++++++++++-------- gstreamer-utils/README.md | 73 +++++++++++++-------- gstreamer-validate/README.md | 94 ++++++++++++++++------------ gstreamer-video/README.md | 73 +++++++++++++-------- gstreamer-webrtc/README.md | 73 +++++++++++++-------- gstreamer/README.md | 73 +++++++++++++-------- 25 files changed, 1157 insertions(+), 689 deletions(-) diff --git a/gstreamer-allocators/README.md b/gstreamer-allocators/README.md index f5bcaa0a3..b27f960db 100644 --- a/gstreamer-allocators/README.md +++ b/gstreamer-allocators/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-app/README.md b/gstreamer-app/README.md index b13b5356e..3252a810c 100644 --- a/gstreamer-app/README.md +++ b/gstreamer-app/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-audio/README.md b/gstreamer-audio/README.md index 1c88cb7ca..66fa1a004 100644 --- a/gstreamer-audio/README.md +++ b/gstreamer-audio/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-base/README.md b/gstreamer-base/README.md index 3dd1f356e..2c481c6eb 100644 --- a/gstreamer-base/README.md +++ b/gstreamer-base/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-check/README.md b/gstreamer-check/README.md index 7704b6929..1191ac04f 100644 --- a/gstreamer-check/README.md +++ b/gstreamer-check/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-controller/README.md b/gstreamer-controller/README.md index 805d02807..db7edd2cb 100644 --- a/gstreamer-controller/README.md +++ b/gstreamer-controller/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-editing-services/README.md b/gstreamer-editing-services/README.md index 94f034008..37f96b8d7 100644 --- a/gstreamer-editing-services/README.md +++ b/gstreamer-editing-services/README.md @@ -71,6 +71,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -86,19 +106,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -108,6 +115,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -125,20 +158,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-gl/README.md b/gstreamer-gl/README.md index bd46049c4..978dd2c6d 100644 --- a/gstreamer-gl/README.md +++ b/gstreamer-gl/README.md @@ -67,6 +67,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -82,19 +102,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -104,6 +111,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -121,20 +154,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-gl/egl/README.md b/gstreamer-gl/egl/README.md index dafc57ac3..82b71b10b 100644 --- a/gstreamer-gl/egl/README.md +++ b/gstreamer-gl/egl/README.md @@ -67,6 +67,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -82,19 +102,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -104,6 +111,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -121,20 +154,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-gl/wayland/README.md b/gstreamer-gl/wayland/README.md index 6940adce0..49ee41a87 100644 --- a/gstreamer-gl/wayland/README.md +++ b/gstreamer-gl/wayland/README.md @@ -67,6 +67,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -82,19 +102,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -104,6 +111,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -121,20 +154,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-gl/x11/README.md b/gstreamer-gl/x11/README.md index bbf280e66..768734c3c 100644 --- a/gstreamer-gl/x11/README.md +++ b/gstreamer-gl/x11/README.md @@ -67,6 +67,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -82,19 +102,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -104,6 +111,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -121,20 +154,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-mpegts/README.md b/gstreamer-mpegts/README.md index 0cbfe27d4..494ce8830 100644 --- a/gstreamer-mpegts/README.md +++ b/gstreamer-mpegts/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-net/README.md b/gstreamer-net/README.md index 07c2bfe9b..48ead31c3 100644 --- a/gstreamer-net/README.md +++ b/gstreamer-net/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-pbutils/README.md b/gstreamer-pbutils/README.md index 35853954c..e6dd23843 100644 --- a/gstreamer-pbutils/README.md +++ b/gstreamer-pbutils/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-play/README.md b/gstreamer-play/README.md index 26ef422ad..d92c3f452 100644 --- a/gstreamer-play/README.md +++ b/gstreamer-play/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-player/README.md b/gstreamer-player/README.md index 7a96ebdee..b5d4a30ef 100644 --- a/gstreamer-player/README.md +++ b/gstreamer-player/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-rtp/README.md b/gstreamer-rtp/README.md index 37b887084..d5f9f110c 100644 --- a/gstreamer-rtp/README.md +++ b/gstreamer-rtp/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-rtsp-server/README.md b/gstreamer-rtsp-server/README.md index bb300744a..ea000785d 100644 --- a/gstreamer-rtsp-server/README.md +++ b/gstreamer-rtsp-server/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-rtsp/README.md b/gstreamer-rtsp/README.md index 557cd3fcc..edeee5693 100644 --- a/gstreamer-rtsp/README.md +++ b/gstreamer-rtsp/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-sdp/README.md b/gstreamer-sdp/README.md index 6d4e4a4a4..7377cef6c 100644 --- a/gstreamer-sdp/README.md +++ b/gstreamer-sdp/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-utils/README.md b/gstreamer-utils/README.md index dacaf8fc2..072dd7071 100644 --- a/gstreamer-utils/README.md +++ b/gstreamer-utils/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-validate/README.md b/gstreamer-validate/README.md index 3586bb239..cbf76a1d3 100644 --- a/gstreamer-validate/README.md +++ b/gstreamer-validate/README.md @@ -24,7 +24,7 @@ API metadata provided by the GStreamer project. ## Installation To build the GStreamer bindings or anything depending on them, you need to -have at least GStreamer 1.8 and gst-plugins-base 1.8 installed. In addition, +have at least GStreamer 1.14 and gst-plugins-base 1.14 installed. In addition, some of the examples/tutorials require various GStreamer plugins to be available, which can be found in gst-plugins-base, gst-plugins-good, gst-plugins-bad, gst-plugins-ugly and/or gst-libav. @@ -45,16 +45,13 @@ $ apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ gstreamer1.0-libav libgstrtspserver-1.0-dev libges-1.0-dev ``` -The minimum required version of the above libraries is >= 1.8. If you +The minimum required version of the above libraries is >= 1.14. If you build the gstreamer-player sub-crate, or any of the examples that -depend on gstreamer-player, you must ensure that in addition to the -above packages, `libgstreamer-plugins-bad1.0-dev` is installed and -that the version is >= 1.12. See the `Cargo.toml` files for the full -details, +depend on gstreamer-player, you must ensure that in addition to the above +packages, `libgstreamer-plugins-bad1.0-dev` is installed. See the `Cargo.toml` +files for the full details, ```console -$ # Only if you wish to install gstreamer-player, make sure the version -$ # of this package is >= 1.12. $ apt-get install libgstreamer-plugins-bad1.0-dev ``` @@ -69,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -82,22 +99,7 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ --enable-gtk3 ``` -If you wish to install the gstreamer-player sub-crate, make sure the -version of these libraries is >= 1.12. Otherwise, a version >= 1.8 is -sufficient. - -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.12.3-x86_64.pkg` and -`gstreamer-1.0-devel-1.12.3-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/Current/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` +Make sure the version of these libraries is >= 1.14. @@ -108,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -118,29 +146,13 @@ $ pacman -S glib2-devel pkg-config \ mingw-w64-x86_64-gst-rtsp-server ``` -If you wish to install the gstreamer-player sub-crate, make sure the -version of these libraries is >= 1.12. Otherwise, a version >= 1.8 is -sufficient. +Make sure the version of these libraries is >= 1.14. Note that the version of `pkg-config` included in `MSYS2` is [known to have problems](https://github.com/rust-lang/pkg-config-rs/issues/51#issuecomment-346300858) compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.12.3.msi` and -`gstreamer-1.0-devel-x86_64-1.12.3.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-video/README.md b/gstreamer-video/README.md index e67cc1259..70a8d1a7b 100644 --- a/gstreamer-video/README.md +++ b/gstreamer-video/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer-webrtc/README.md b/gstreamer-webrtc/README.md index 1dfe5b9ba..25207beb6 100644 --- a/gstreamer-webrtc/README.md +++ b/gstreamer-webrtc/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started diff --git a/gstreamer/README.md b/gstreamer/README.md index 781db2db5..e59c719b4 100644 --- a/gstreamer/README.md +++ b/gstreamer/README.md @@ -66,6 +66,26 @@ You can install GStreamer and the plugins via [Homebrew](https://brew.sh/) or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/osx/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over Homebrew, especially +as GStreamer in Homebrew is [currently broken](https://github.com/orgs/Homebrew/discussions/3740#discussioncomment-3804964). + +#### GStreamer Binaries + +You need to download the *two* `.pkg` files from the GStreamer website and +install them, e.g. `gstreamer-1.0-1.20.4-universal.pkg` and +`gstreamer-1.0-devel-1.20.4-universal.pkg`. + +After installation, you also need to set the `PATH` environment variable as +follows + +```console +$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}" +``` + +Also note that the `pkg-config` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### Homebrew Homebrew only installs various plugins if explicitly enabled, so some extra @@ -81,19 +101,6 @@ $ brew install gstreamer gst-plugins-base gst-plugins-good \ Make sure the version of these libraries is >= 1.14. -#### GStreamer Binaries - -You need to download the *two* `.pkg` files from the GStreamer website and -install them, e.g. `gstreamer-1.0-1.14.0-x86_64.pkg` and -`gstreamer-1.0-devel-1.14.0-x86_64.pkg`. - -After installation, you also need to install `pkg-config` (e.g. via Homebrew) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ### Windows @@ -103,6 +110,32 @@ with `pacman` or by installing the [binaries](https://gstreamer.freedesktop.org/data/pkg/windows/) provided by the GStreamer project. +We recommend using the official GStreamer binaries over MSYS2. + +#### GStreamer Binaries + +You need to download the *two* `.msi` files for your platform from the +GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.20.4.msi` and +`gstreamer-1.0-devel-x86_64-1.20.4.msi`. Make sure to select the version that +matches your Rust toolchain, i.e. MinGW or MSVC. + +After installation set the ``PATH` environment variable as follows: + +```console +# For a UNIX-style shell: +$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}" + +# For cmd.exe: +$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH% +``` + +Make sure to update the path to where you have actually installed GStreamer +and for the corresponding toolchain. + +Also note that the `pkg-config.exe` from GStreamer should be the first one in +the `PATH` as other versions have all kinds of quirks that will cause +problems. + #### MSYS2 / pacman ```console @@ -120,20 +153,6 @@ Note that the version of `pkg-config` included in `MSYS2` is compiling GStreamer, so you may need to install another version. One option would be [`pkg-config-lite`](https://sourceforge.net/projects/pkgconfiglite/). -#### GStreamer Binaries - -You need to download the *two* `.msi` files for your platform from the -GStreamer website and install them, e.g. `gstreamer-1.0-x86_64-1.14.0.msi` and -`gstreamer-1.0-devel-x86_64-1.14.0.msi`. - -After installation, you also need to install `pkg-config` (e.g. via MSYS2 or -from [here](https://sourceforge.net/projects/pkgconfiglite/)) -and set the `PKG_CONFIG_PATH` environment variable - -```console -$ export PKG_CONFIG_PATH="c:\\gstreamer\\1.0\\x86_64\\lib\\pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}" -``` - ## Getting Started