build and run a GStreamer pipeline from an XML serialization




gst-xmllaunch is a tool that is used to build and run a basic GStreamer pipeline, loading it from an XML description. You can produce the XML description using gst-launch-0.10(1) with the -o option or by calling gst_xml_write_file() in your own app.

A simple commandline looks like:

gst-xmllaunch my-pipeline.xml filesrc0.location=music.mp3

This sets the location property of the element named filesrc0 to the value "music.mp3". See gst-launch(1) for syntax on setting element names, and gst-inspect to see what properties various elements have.

You can pass "-" as the XML-FILE to read from stdin.

XML-FILE can be a URI as well, thanks to the wizardry of libxml. I’m not really sure what all is supported, it seems http works just fine though.


gst-xmllaunch is deprecated and broken for all but the most simple pipelines. It will most likely be removed in future. Don’t use it.


gst-xmllaunch accepts the following options:


Print help synopsis and available FLAGS


Do not output status information

--exclude=TYPE, -XTYPE

Do not output status information of TYPE

--output=FILE, -oFILE

Save XML representation of pipeline to FILE and exit


GStreamer info flags to set (list with --help)


GStreamer debugging flags to set (list with --help)


GStreamer info and debugging flags to set (list with --help)


GStreamer info flags to set Enable printout of errors while loading GStreamer plugins


Add directories separated with ’:’ to the plugin search path


gst-feedback(1), gst-inspect(1), gst-launch(1), gst-typefind(1)


The GStreamer team at

Copied to clipboard