Gstreamer video recorder: add python bindings

applications/gstreamer/gst_video_recorder/CMakeLists.txt

@@ -13,73 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-project(gst_video_recorder CXX)
-
-find_package(holoscan REQUIRED CONFIG
-             PATHS "/opt/nvidia/holoscan" "/workspace/holoscan-sdk/install")
-
-add_executable(gst-video-recorder
-  ../common/pattern_generator.cpp
-  gst_video_recorder.cpp
-)
-
-target_include_directories(gst-video-recorder
-  PRIVATE
-  ${CMAKE_CURRENT_SOURCE_DIR}/../common
-)
-
-target_link_libraries(gst-video-recorder
-  PRIVATE
-  holoscan::core
-  holoscan::ops::gstreamer_bridge
-  holoscan::ops::v4l2
-  holoscan::ops::format_converter
-)
-
-# Install target
-install(TARGETS gst-video-recorder DESTINATION bin/gst_video_recorder)
-
-
-if(BUILD_TESTING)
-    # Set and create the recording directory
-    set(RECORDING_DIR ${CMAKE_CURRENT_BINARY_DIR}/recording_output)
-    file(MAKE_DIRECTORY ${RECORDING_DIR})
-
-    # Set the output file
-    set(OUTPUT_FILE ${RECORDING_DIR}/test_output.mp4)
-    message(STATUS "Output test file: ${OUTPUT_FILE}")
-
-    # Test 1: check if the pipeline runs successfully
-    add_test(
-        NAME gst_video_recorder_test
-        COMMAND $<TARGET_FILE:gst-video-recorder> --source pattern --count 10 -o ${OUTPUT_FILE}
-        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
-    )
-
-    # Set the test passing if the pipeline runs successfully
-    set_tests_properties(gst_video_recorder_test PROPERTIES
-        PASS_REGULAR_EXPRESSION "EOS processed, pipeline finished cleanly"
-    )
-
-    # Test 2: check if the output file was created
-    add_test(
-        NAME gst_video_recorder_output_file_test
-        COMMAND bash -c "test -f ${OUTPUT_FILE}"
-    )
-
-    # Make the file check test depend on the pipeline test
-    set_tests_properties(gst_video_recorder_output_file_test PROPERTIES
-        DEPENDS gst_video_recorder_test
-    )
-
-    # Test 3: check if the output file is a valid MPEG video file
-    add_test(
-        NAME gst_video_recorder_valid_mpeg_test
-        COMMAND bash -c "ffprobe -v error ${OUTPUT_FILE}"
-    )
+if(HOLOHUB_BUILD_CPP)
+  add_subdirectory(cpp)
+endif()
 
-    # Make the validation test depend on the file check test
-    set_tests_properties(gst_video_recorder_valid_mpeg_test PROPERTIES
-        DEPENDS gst_video_recorder_output_file_test
-    )
+if(HOLOHUB_BUILD_PYTHON)
+  add_subdirectory(python)
 endif()

applications/gstreamer/gst_video_recorder/README.md

@@ -2,6 +2,10 @@
 
 A Holoscan application that demonstrates video recording using the GStreamer encoding pipeline.
 
+This application is available in both **C++** and **Python** implementations.
+Both versions expose the **same command-line interface** and behavior.
+The only difference when building or launching the application is the `--language` flag: use `--language cpp` for the C++ version or `--language python` for the Python version.
+
 ![GStreamer Video Recorder Pipeline](docs/pipeline_diagram.png)
 *Fig. 1: Application architecture showing the integration of Holoscan operators with GStreamer's encoding pipeline*
 
@@ -42,11 +46,19 @@ For more information about this application, refer to:
 
 ## Quick Start
 
-To run the application with the default settings, run one of the following commands:
+To run the application with the default settings, choose the implementation with `--language cpp` or `--language python` and then use the same runtime arguments.
+
+Examples with the C++ implementation:
+
+| Using the V4L2 Camera | Generating Test Patterns |
+| --- | --- |
+| `./holohub run gst_video_recorder --language cpp v4l2` | `./holohub run gst_video_recorder --language cpp pattern` |
+
+Examples with the Python implementation:
 
 | Using the V4L2 Camera | Generating Test Patterns |
 | --- | --- |
-| `./holohub run gst_video_recorder v4l2` | `./holohub run gst_video_recorder pattern` |
+| `./holohub run gst_video_recorder --language python v4l2` | `./holohub run gst_video_recorder --language python pattern` |
 
 These commands build and run the customized container for this application with all the dependencies installed (defined by `Dockerfile`), and then build and start the application using the default settings. The output video will be saved in the build directory as `output.mp4`.
 
@@ -66,14 +78,16 @@ The `install_deps.sh` script installs:
 - GStreamer development libraries
 - All necessary GStreamer plugins for encoding
 
-Choose one of the following options to build the application:
+Choose one of the following options to build the application.
+Select the implementation with `--language cpp` or `--language python`:
 
 | Containerized Build (Recommended) | Local Build |
 | --- | --- |
-| Install the application: | Install dependencies, from the `gst_video_recorder` directory: |
-| `./holohub build gst_video_recorder` | `./install_deps.sh` |
-| | Then build locally: |
-| | `./holohub build --local gst_video_recorder` |
+| No manual dependency installation is required. Dependencies are installed in the application container image. | Install dependencies on the host, from the `gst_video_recorder` directory: |
+| `./holohub build gst_video_recorder --language cpp` | `./install_deps.sh` |
+| `./holohub build gst_video_recorder --language python` | Then build locally: |
+| | `./holohub build --local gst_video_recorder --language cpp` |
+| | `./holohub build --local gst_video_recorder --language python` |
 
 ### Usage Reference
 
@@ -87,7 +101,7 @@ Reference for running `gst_video_recorder` that includes:
 The recommended way to run the application is through the `holohub` launcher:
 
 ```bash
-./holohub run gst_video_recorder --run-args="[OPTIONS]"
+./holohub run gst_video_recorder --language <cpp|python> --run-args="[OPTIONS]"
 ```
 
 Alternatively, if you know the binary location, you can run it directly:

applications/gstreamer/gst_video_recorder/cpp/CMakeLists.txt

@@ -0,0 +1,85 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+project(gst_video_recorder CXX)
+
+find_package(holoscan REQUIRED CONFIG
+             PATHS "/opt/nvidia/holoscan" "/workspace/holoscan-sdk/install")
+
+add_executable(gst-video-recorder
+  ../../common/pattern_generator.cpp
+  gst_video_recorder.cpp
+)
+
+target_include_directories(gst-video-recorder
+  PRIVATE
+  ${CMAKE_CURRENT_SOURCE_DIR}/../common
+)
+
+target_link_libraries(gst-video-recorder
+  PRIVATE
+  holoscan::core
+  holoscan::ops::gstreamer_bridge
+  holoscan::ops::v4l2
+  holoscan::ops::format_converter
+)
+
+# Install target
+install(TARGETS gst-video-recorder DESTINATION bin/gst_video_recorder)
+
+
+if(BUILD_TESTING)
+    # Set and create the recording directory
+    set(RECORDING_DIR ${CMAKE_CURRENT_BINARY_DIR}/recording_output)
+    file(MAKE_DIRECTORY ${RECORDING_DIR})
+
+    # Set the output file
+    set(OUTPUT_FILE ${RECORDING_DIR}/test_output.mp4)
+    message(STATUS "Output test file: ${OUTPUT_FILE}")
+
+    # Test 1: check if the pipeline runs successfully
+    add_test(
+        NAME gst_video_recorder_test
+        COMMAND $<TARGET_FILE:gst-video-recorder> --source pattern --count 10 -o ${OUTPUT_FILE}
+        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
+    )
+
+    # Set the test passing if the pipeline runs successfully
+    set_tests_properties(gst_video_recorder_test PROPERTIES
+        PASS_REGULAR_EXPRESSION "EOS processed, pipeline finished cleanly"
+    )
+
+    # Test 2: check if the output file was created
+    add_test(
+        NAME gst_video_recorder_output_file_test
+        COMMAND bash -c "test -f ${OUTPUT_FILE}"
+    )
+
+    # Make the file check test depend on the pipeline test
+    set_tests_properties(gst_video_recorder_output_file_test PROPERTIES
+        DEPENDS gst_video_recorder_test
+    )
+
+    # Test 3: check if the output file is a valid MPEG video file
+    add_test(
+        NAME gst_video_recorder_valid_mpeg_test
+        COMMAND bash -c "ffprobe -v error ${OUTPUT_FILE}"
+    )
+
+    # Make the validation test depend on the file check test
+    set_tests_properties(gst_video_recorder_valid_mpeg_test PROPERTIES
+        DEPENDS gst_video_recorder_output_file_test
+    )
+endif()

applications/gstreamer/gst_video_recorder/gst_video_recorder.cpp → applications/gstreamer/gst_video_recorder/cpp/gst_video_recorder.cpp

@@ -25,8 +25,8 @@
 #include <holoscan/operators/v4l2_video_capture/v4l2_video_capture.hpp>
 #include <holoscan/operators/format_converter/format_converter.hpp>
 #include <gst_video_recorder_op.hpp>
-#include "pattern_generator.hpp"
-#include "../common/arg_parser.hpp"
+#include "../../common/pattern_generator.hpp"
+#include "../../common/arg_parser.hpp"
 
 namespace {
 

applications/gstreamer/gst_video_recorder/metadata.json → applications/gstreamer/gst_video_recorder/cpp/metadata.json

@@ -8,9 +8,10 @@
 			}
 		],
 		"language": "C++",
-		"version": "1.0.0",
+		"version": "1.1.0",
 		"changelog": {
-			"1.0.0": "Initial Release"
+			"1.0.0": "Initial Release",
+			"1.1.0": "Moved C++ implementation to cpp subtree"
 		},
 		"requirements": {
 			"system_packages": [
@@ -29,7 +30,7 @@
 		"holoscan_sdk": {
 			"minimum_required_version": "3.8.0",
 			"tested_versions": [
-				"3.8.0"
+				"4.1.0"
 			]
 		},
 		"platforms": [
@@ -44,21 +45,21 @@
 			"default": {
 				"description": "Record Holoscan video streams to file using GStreamer encoding (V4L2 camera or pattern generator).",
 				"run": {
-					"command": "applications/gstreamer/gst_video_recorder/gst-video-recorder",
+					"command": "<holohub_app_bin>/gst-video-recorder",
 					"workdir": "holohub_bin"
 				}
 			},
 			"v4l2": {
 				"description": "Record video from a V4L2 camera",
 				"run": {
-					"command": "applications/gstreamer/gst_video_recorder/gst-video-recorder --source v4l2",
+					"command": "<holohub_app_bin>/gst-video-recorder --source v4l2",
 					"workdir": "holohub_bin"
 				}
 			},
 			"pattern": {
 				"description": "Record a pattern generator video",
 				"run": {
-					"command": "applications/gstreamer/gst_video_recorder/gst-video-recorder --source pattern",
+					"command": "<holohub_app_bin>/gst-video-recorder --source pattern",
 					"workdir": "holohub_bin"
 				}
 			}

applications/gstreamer/gst_video_recorder/python/CMakeLists.txt

@@ -0,0 +1,58 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026, TECNALIA. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copy gst_video_recorder application file
+add_custom_target(python_gst_video_recorder ALL
+  COMMAND ${CMAKE_COMMAND} -E copy
+          "${CMAKE_CURRENT_SOURCE_DIR}/gst_video_recorder.py"
+          ${CMAKE_CURRENT_BINARY_DIR}
+  DEPENDS "gst_video_recorder.py"
+  BYPRODUCTS "gst_video_recorder.py"
+)
+
+# Add testing
+if(BUILD_TESTING)
+  # To get the environment path
+  find_package(holoscan 1.0 REQUIRED CONFIG PATHS "/opt/nvidia/holoscan" "/workspace/holoscan-sdk/install")
+
+  set(RECORDING_DIR ${CMAKE_CURRENT_BINARY_DIR}/recording_output)
+  file(MAKE_DIRECTORY ${RECORDING_DIR})
+
+  add_test(
+    NAME gst_video_recorder_python_test
+    COMMAND python3 ${CMAKE_CURRENT_SOURCE_DIR}/gst_video_recorder.py
+            --source pattern
+            --count 10
+            -o ${RECORDING_DIR}/python_gst_video_recorder_output.mp4
+    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
+  )
+
+  set_property(
+    TEST gst_video_recorder_python_test
+    PROPERTY ENVIRONMENT
+      "PYTHONPATH=${GXF_LIB_DIR}/../python/lib:${CMAKE_BINARY_DIR}/python/lib"
+  )
+
+  set_tests_properties(gst_video_recorder_python_test PROPERTIES
+    PASS_REGULAR_EXPRESSION "EOS processed, pipeline finished cleanly"
+    FAIL_REGULAR_EXPRESSION "[^a-z]Error;ERROR;Failed"
+  )
+endif()
+
+# Install application into the install/ directory for packaging
+install(
+  FILES gst_video_recorder.py
+  DESTINATION bin/gst_video_recorder/python
+)