Key Features:
- Embed & Retrieve Metadata Within RTMP Streams: Insert text or binary metadata directly into live RTMP video streams, and extract it on the receiver side using standard GStreamer APIs.
- Designed for Live Streaming: Perfect for broadcasting pipelines where metadata needs to travel end-to-end with minimal latency.
- No Auxiliary Communication Channel Needed: Metadata stays inside the same RTMP stream—no WebSockets, UDP side-streams, sidecar files, or external signaling required.
- Flexible Data Payloads with Minimal Overhead: Attach user-defined metadata (e.g., GPS coordinates, AI model outputs, timestamps, sensor values) without impacting playback or encoder behavior.
- Full GStreamer Integration: Compatible with existing FLV-based muxing workflows and works transparently within standard GStreamer pipelines.
Example Use Case
A remote drone surveillance system uses GstRTMPMetadata to embed GPS location, IMU data, and AI object detection results directly into a live RTMP video feed. Ground control systems and cloud visualization dashboards can then decode both video and metadata together enabling synchronized playback, automated event tagging, or real-time decision-making without external metadata stitching.
What’s Included
-
GstRTMPMetadata plugin extending
flvmuxandflvdemux -
Developer documentation and usage examples
-
Sample
gst-launch-1.0pipelines for sending and receiving metadata
Supported Platforms
-
NVIDIA Jetson
-
x86 Linux systems
-
Any Linux system running one of the supported GStreamer versions
Supported GStreamer Versions
GstRTMPMetadata is currently supported on the following GStreamer releases:
-
1.16.3
-
1.20.3
-
1.24.x
Other versions may be supported through a custom porting engagement.
Platform Compatibility Disclaimer (Streaming Services)
GstRTMPMetadata does not include out-of-the-box compatibility with commercial streaming platforms such as YouTube Live, Facebook Live, or other CDN/RTMP hosting services, as these platforms may modify, strip, or ignore custom metadata fields.
However, compatibility can be evaluated and enabled through a dedicated integration or support engagement.
Why RidgeRun?
With nearly two decades of embedded multimedia expertise, RidgeRun builds high-performance solutions for real-time video streaming, robotics, vision analytics, and edge computing. GstRTMPMetadata brings synchronized, intelligent metadata transport to RTMP pipelines.
Explore the developer wiki
Learn the basics
Read the user guide
View example GStreamer pipelines
Monthly Subscription
Hire RidgeRun at a flat monthly rate for a maximum of 8 hours per day, 40 hours per week each month. Get fast interaction with engineers working on your project, weekly 45 minute calls to update you on our progress, and the complete engagement and expertise of our engineering team.
Work With UsCustomer Reviews
“I must say thus far yourself and the entire RidgeRun team have been a pleasure to work with. I realize what we have been asking for is on the demanding end of the spectrum. I am genuinely appreciative for all of the assistance you’ve provided us so far and have shown a notable amount of good-will in this effort. It has not gone unnoticed.”
Customer industry:
AudioVisual Devices
Customer Reviews
“It's been an absolute pleasure working with you, and everyone there at RidgeRun continues to impress us here. I've worked with many contractors and companies over my career and you are by far the most proficient and knowledgeable.”
Customer industry:
Drones
Customer Reviews
"As a side note: just to let you know, I'm really happy to be working with RidgeRun in general. It's pretty clear that you tell it like you see it, and know what you do and don't know; it's really refreshing. That's super rare on these kinds of technical engagements when everyone seems to either want to claim expertise they don't have, or are so cautious they are don't actually say anything useful"
Customer industry:
Drones and Robotics
Customer Reviews
"RidgeRun has been so good that part of me doesn't even want to write this testimonial—because if more companies discover them, I might have to share the amazing engineers I get to work with. But credit where credit's due: their team is sharp, responsive, and consistently delivers beyond expectations. They make tough technical challenges feel easy, and that's rare."
Ayman
Director of Software