1.5 KiB

gst-launch-1.0

Build and run a GStreamer pipeline. See also: gst-inspect-1.0, ffmpeg. More information: https://gstreamer.freedesktop.org/documentation/tools/gst-launch.html.

  • Play test video in a window:

gst-launch-1.0 videotestsrc ! autovideosink

  • Play test audio and enable verbose output:

gst-launch-1.0 audiotestsrc {{[-v|--verbose]}} ! autoaudiosink

  • Play a media file in a window:

gst-launch-1.0 playbin uri={{protocol}}://{{host}}/{{path/to/file}}

  • Re-encode a media file:

gst-launch-1.0 filesrc location={{path/to/file}} ! {{file_type}}demux ! {{codec_type}}dec ! {{codec_type}}enc ! {{file_type}}mux ! filesink location={{path/to/file}}

  • Stream a file to an RTSP server:

gst-launch-1.0 filesrc location={{path/to/file}} ! rtspclientsink location=rtsp://{{host_ip}}/{{path/to/file}}

  • Force an End Of Stream event if the pipeline is shut down with <Ctrl c> for containers that require finalization such as mp4:

gst-launch-1.0 {{[-e|--eos-on-shutdown]}} videotestsrc ! x264enc ! mp4mux ! filesink location={{path/to/file.mp4}}

  • Multiplex together test video and test audio into a file:

gst-launch-1.0 {{[-e|--eos-on-shutdown]}} videotestsrc ! {{x264enc}} ! {{element_name}}. audiotestsrc ! {{opusenc}} ! {{element_name}}. {{matroskamux}} name={{element_name}} ! filesink location={{path/to/file.mkv}}

  • Enable debug output and dump a pipeline into a .dot file which can then be rendered with tools like dot:

GST_DEBUG={{1..5}} GST_DEBUG_DUMP_DOT_DIR={{path/to/directory}} gst-launch-1.0 {{pipeline}}