GstRerunSink - Example - GstRerunSink: stream to rerun viewer

From RidgeRun Developer Wiki


Previous: Example - GstRerunSink: stream to file Index Next: Contact Us




This page provides a test pipeline to use with the GstRerunSink element and redirect its output to a Rerun viewer

The perf element can be downloaded from the gst-perf GitHub repository. Otherwise, the element can be removed from the pipeline without any issues.

Spawn Local Viewer

Example pipeline

# Test pattern visualization (spawns viewer by default)
gst-launch-1.0 videotestsrc ! \
    video/x-raw,format=RGB,width=640,height=480 ! \
    rerunsink recording-id="test" image-path="camera/image"

Disable viewer spawning

Example pipeline

gst-launch-1.0 videotestsrc ! \
    video/x-raw,format=RGB ! \
    rerunsink recording-id="test" image-path="camera/image" spawn-viewer=false

Connect to Remote Viewer

The remote viewer can be opened with this command:

# starts the Rerun viewer in server mode, configured to receive incoming telemetry or data streams over gRPC from a Rerun SDK client (e.g. Python, C++, Rust).
rerun serve_grpc


Example pipeline

# Setting a custom grpc-address automatically enables gRPC mode
gst-launch-1.0 videotestsrc ! \
    video/x-raw,format=RGB ! \
    rerunsink recording-id="remote-test" image-path="camera/image" \
    grpc-address="rerun+http://127.0.0.1:9876/proxy"

Connect to local viewer on custom port

Example pipeline

gst-launch-1.0 videotestsrc ! \
    video/x-raw,format=RGB ! \
    rerunsink recording-id="test" image-path="camera/image" \
    grpc-address="rerun+http://127.0.0.1:9876/proxy"

Hardware-accelerated decode with remote viewer

Example pipeline

gst-launch-1.0 filesrc location=video.mp4 ! \
    qtdemux ! h264parse ! nvv4l2decoder ! \
    'video/x-raw(memory:NVMM),format=NV12' ! \
    rerunsink recording-id="hw-decode" image-path="video/decoded" \
    grpc-address="rerun+http://127.0.0.1:9876/proxy"


Previous: Example - GstRerunSink: stream to file Index Next: Contact Us