Skip to content

Commit 675bbcf

Browse files
solved #1138 by Adding missing Windows GStreamer build documentation
1 parent bfb85dc commit 675bbcf

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

README.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,38 @@ If some dependency is not enabled in the pre-built wheels, you can also run the
161161
- Optional: on Linux use some of the `manylinux` images as a build hosts if maximum portability is needed and run `auditwheel` for the wheel after build
162162
- Optional: on macOS use ``delocate`` (same as ``auditwheel`` but for macOS) for better portability
163163

164+
#### Building with GStreamer on Windows
165+
166+
To build opencv-python with GStreamer support on Windows, you must install
167+
the official GStreamer MSVC binaries and make them available to CMake during
168+
the build process.
169+
170+
**Prerequisites**
171+
- Windows 10 or later (64-bit)
172+
- Visual Studio 2019 or newer (MSVC)
173+
- CMake
174+
- Python (matching the target wheel version)
175+
- GStreamer 1.x MSVC (runtime + development packages)
176+
177+
**Install GStreamer**
178+
Download and install both the **runtime** and **development** installers for
179+
GStreamer 1.x (MSVC 64-bit) from the official GStreamer website.
180+
181+
**Environment variables**
182+
Before building, ensure the following paths are available:
183+
184+
set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH%
185+
set GST_PLUGIN_PATH=C:\gstreamer\1.0\msvc_x86_64\lib\gstreamer-1.0
186+
187+
Adjust paths if GStreamer is installed in a different location.
188+
189+
**Build**
190+
Run the standard manual build command:
191+
192+
If GStreamer is detected correctly, the CMake output will indicate that
193+
GStreamer support is enabled.
194+
195+
164196
#### Manual debug builds
165197

166198
In order to build `opencv-python` in an unoptimized debug build, you need to side-step the normal process a bit.

0 commit comments

Comments
 (0)