GStreamer(1) GStreamer(1)
NAME
gst-launch - build and run a GStreamer pipeline
SYNOPSIS
gst-launch [OPTION...] PIPELINE-DESCRIPTION
DESCRIPTION
gst-launch is a tool that builds and runs basic GStreamer pipelines.
In simple form, a PIPELINE-DESCRIPTION is a list of elements separated by exclamation marks (!). Properties may be appended to elements, in the
form property=value.
For a complete description of possible PIPELINE-DESCRIPTIONS see the section pipeline description below or consult the GStreamer documentation.
Please note that gst-launch is primarily a debugging tool for developers and users. You should not build applications on top of it. For applicaâ
tions, use the gst_parse_launch() function of the GStreamer API as an easy way to construct pipelines from pipeline descriptions.
OPTIONS
gst-launch accepts the following options:
--help Print help synopsis and available FLAGS
-v, --verbose
Output status information and property notifications
-q, --quiet
Do not print any progress information
-m, --messages
Output messages posted on the pipeline's bus
-t, --tags
Output tags (also known as metadata)
-e, --eos-on-shutdown
Force an EOS event on sources before shutting the pipeline down. This is useful to make sure muxers create readable files when a muxing
pipeline is shut down forcefully via Control-C.
-i, --index
Gather and print index statistics. This is mostly useful for playback or recording pipelines.
-o FILE, --output=FILE
Save XML representation of pipeline to FILE and exit (DEPRECATED, DO NOT USE)
-f, --no-fault
Do not install a fault handler
--no-sigusr-handler
Do not install signal handlers for SIGUSR1 (play) and SIGUSR2 (stop)
-T, --trace
Print memory allocation traces. The feature must be enabled at compile time to work.
GSTREAMER OPTIONS
gst-launch also accepts the following options that are common to all GStreamer applications:
--gst-version
Prints the version string of the GStreamer core library.
--gst-fatal-warnings
Causes GStreamer to abort if a warning message occurs. This is equivalent to setting the environment variable G_DEBUG to 'fatal_warnings'
(see the section environment variables below for further information).
--gst-debug=STRING
A comma separated list of category_name:level pairs to specify debugging levels for each category. Level is in the range 0-5 where 0 will
show no messages, and 5 will show all messages. The wildcard * can be used to match category names.
Use --gst-debug-help to show category names
Example: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5
--gst-debug-level=LEVEL
Sets the threshold
NAME
gst-launch - build and run a GStreamer pipeline
SYNOPSIS
gst-launch [OPTION...] PIPELINE-DESCRIPTION
DESCRIPTION
gst-launch is a tool that builds and runs basic GStreamer pipelines.
In simple form, a PIPELINE-DESCRIPTION is a list of elements separated by exclamation marks (!). Properties may be appended to elements, in the
form property=value.
For a complete description of possible PIPELINE-DESCRIPTIONS see the section pipeline description below or consult the GStreamer documentation.
Please note that gst-launch is primarily a debugging tool for developers and users. You should not build applications on top of it. For applicaâ
tions, use the gst_parse_launch() function of the GStreamer API as an easy way to construct pipelines from pipeline descriptions.
OPTIONS
gst-launch accepts the following options:
--help Print help synopsis and available FLAGS
-v, --verbose
Output status information and property notifications
-q, --quiet
Do not print any progress information
-m, --messages
Output messages posted on the pipeline's bus
-t, --tags
Output tags (also known as metadata)
-e, --eos-on-shutdown
Force an EOS event on sources before shutting the pipeline down. This is useful to make sure muxers create readable files when a muxing
pipeline is shut down forcefully via Control-C.
-i, --index
Gather and print index statistics. This is mostly useful for playback or recording pipelines.
-o FILE, --output=FILE
Save XML representation of pipeline to FILE and exit (DEPRECATED, DO NOT USE)
-f, --no-fault
Do not install a fault handler
--no-sigusr-handler
Do not install signal handlers for SIGUSR1 (play) and SIGUSR2 (stop)
-T, --trace
Print memory allocation traces. The feature must be enabled at compile time to work.
GSTREAMER OPTIONS
gst-launch also accepts the following options that are common to all GStreamer applications:
--gst-version
Prints the version string of the GStreamer core library.
--gst-fatal-warnings
Causes GStreamer to abort if a warning message occurs. This is equivalent to setting the environment variable G_DEBUG to 'fatal_warnings'
(see the section environment variables below for further information).
--gst-debug=STRING
A comma separated list of category_name:level pairs to specify debugging levels for each category. Level is in the range 0-5 where 0 will
show no messages, and 5 will show all messages. The wildcard * can be used to match category names.
Use --gst-debug-help to show category names
Example: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5
--gst-debug-level=LEVEL
Sets the threshold