# gst-launch-1.0

> Build and run a GStreamer pipeline.
> See also: `gst-inspect-1.0`.
> 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:

`gst-launch-1.0 audiotestsrc ! 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}}`

- Dump a pipeline into a `.dot` file which can then be rendered with tools like `dot`:

`GST_DEBUG_DUMP_DOT_DIR={{path/to/directory}} gst-launch-1.0 {{pipeline}}`