2007-05-02 17:09:30 +00:00
|
|
|
.TH "GStreamer" "1" "May 2007"
|
2001-07-24 20:05:27 +00:00
|
|
|
.SH "NAME"
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 \- build and run a GStreamer pipeline
|
2001-07-24 20:05:27 +00:00
|
|
|
.SH "SYNOPSIS"
|
2016-11-03 09:30:53 +00:00
|
|
|
\fBgst\-launch\-1.0\fR \fI[OPTION...]\fR PIPELINE\-DESCRIPTION
|
2001-07-24 20:05:27 +00:00
|
|
|
.SH "DESCRIPTION"
|
2011-02-21 09:24:45 +00:00
|
|
|
.LP
|
2016-11-03 09:30:53 +00:00
|
|
|
\fIgst\-launch\-1.0\fP is a tool that builds and runs basic
|
2003-02-01 22:38:08 +00:00
|
|
|
\fIGStreamer\fP pipelines.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-02-01 22:38:08 +00:00
|
|
|
In simple form, a PIPELINE\-DESCRIPTION is a list of
|
2006-01-12 16:31:35 +00:00
|
|
|
elements separated by exclamation marks (!). Properties may be appended to
|
2003-04-25 20:15:54 +00:00
|
|
|
elements, in the form \fIproperty=value\fR.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2005-12-17 14:19:27 +00:00
|
|
|
For a complete description of possible PIPELINE-DESCRIPTIONS see the section
|
|
|
|
\fIpipeline description\fR below or consult the GStreamer documentation.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-03 09:30:53 +00:00
|
|
|
Please note that \fIgst\-launch\-1.0\fP is primarily a debugging tool for
|
2005-12-17 14:19:27 +00:00
|
|
|
developers and users. You should not build applications on top of it. For
|
|
|
|
applications, use the gst_parse_launch() function of the GStreamer API as an
|
|
|
|
easy way to construct pipelines from pipeline descriptions.
|
2003-04-25 20:15:54 +00:00
|
|
|
.
|
|
|
|
.SH "OPTIONS"
|
|
|
|
.l
|
2016-11-03 09:30:53 +00:00
|
|
|
\fIgst\-launch\-1.0\fP accepts the following options:
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
|
|
|
.B \-\-help
|
|
|
|
Print help synopsis and available FLAGS
|
|
|
|
.TP 8
|
2005-02-08 18:05:29 +00:00
|
|
|
.B \-v, \-\-verbose
|
2009-02-09 20:49:05 +00:00
|
|
|
Output status information and property notifications
|
|
|
|
.TP 8
|
2009-09-30 06:47:23 +00:00
|
|
|
.B \-q, \-\-quiet
|
2009-02-09 20:49:05 +00:00
|
|
|
Do not print any progress information
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
2005-12-17 14:19:27 +00:00
|
|
|
.B \-m, \-\-messages
|
|
|
|
Output messages posted on the pipeline's bus
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
2005-12-17 14:19:27 +00:00
|
|
|
.B \-t, \-\-tags
|
|
|
|
Output tags (also known as metadata)
|
|
|
|
.TP 8
|
2010-06-28 12:56:00 +00:00
|
|
|
.B \-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.
|
|
|
|
.TP 8
|
2011-02-21 09:24:45 +00:00
|
|
|
.B \-i, \-\-index
|
|
|
|
Gather and print index statistics. This is mostly useful for playback or
|
|
|
|
recording pipelines.
|
|
|
|
.TP 8
|
2010-06-24 16:22:13 +00:00
|
|
|
.B \-f, \-\-no\-fault
|
2003-04-25 20:15:54 +00:00
|
|
|
Do not install a fault handler
|
|
|
|
.TP 8
|
2005-12-17 14:19:27 +00:00
|
|
|
.B \-T, \-\-trace
|
2003-04-25 20:15:54 +00:00
|
|
|
Print memory allocation traces. The feature must be enabled at compile time to
|
|
|
|
work.
|
2003-07-14 08:25:16 +00:00
|
|
|
.TP 8
|
2019-05-30 11:53:34 +00:00
|
|
|
.B \-\-no\-position
|
2019-11-12 02:24:45 +00:00
|
|
|
Do not print current position of pipeline.
|
|
|
|
If this option is unspecified, the position will be printed when stdout is a TTY.
|
|
|
|
To enable printing position when stdout is not a TTY,
|
|
|
|
use "force-position" option.
|
|
|
|
.TP 8
|
|
|
|
.B \-\-force\-position
|
|
|
|
Allow printing current position of pipeline even if stdout is not a TTY.
|
|
|
|
This option has no effect if the "no-position" option is specified.
|
2019-05-30 11:53:34 +00:00
|
|
|
.TP 8
|
2003-07-12 21:51:21 +00:00
|
|
|
|
|
|
|
.
|
|
|
|
.SH "GSTREAMER OPTIONS"
|
|
|
|
.l
|
2016-11-03 09:30:53 +00:00
|
|
|
\fIgst\-launch\-1.0\fP also accepts the following options that are common
|
2003-07-12 21:51:21 +00:00
|
|
|
to all GStreamer applications:
|
|
|
|
.TP 8
|
|
|
|
.B \-\-gst\-version
|
|
|
|
Prints the version string of the \fIGStreamer\fP core library.
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
2003-07-12 21:51:21 +00:00
|
|
|
.B \-\-gst\-fatal\-warnings
|
2005-12-17 14:19:27 +00:00
|
|
|
Causes \fIGStreamer\fP to abort if a warning message occurs. This is equivalent
|
|
|
|
to setting the environment variable G_DEBUG to 'fatal_warnings' (see the
|
|
|
|
section \fIenvironment variables\fR below for further information).
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
2003-07-12 21:51:21 +00:00
|
|
|
.B \-\-gst\-debug=STRING
|
2005-12-17 14:19:27 +00:00
|
|
|
A comma separated list of category_name:level pairs to specify debugging levels
|
2013-01-18 16:01:11 +00:00
|
|
|
for each category. Level is in the range 0-9 where 0 will show no messages, and
|
|
|
|
9 will show all messages. The wildcard * can be used to match category names.
|
|
|
|
Note that the order of categories and levels is important, wildcards at the
|
|
|
|
end may override levels set earlier. The log levels are: 1=ERROR, 2=WARNING,
|
|
|
|
3=FIXME, 4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Since GStreamer 1.2 one
|
2013-01-18 16:05:09 +00:00
|
|
|
can also use the debug level names, e.g. \-\-gst\-debug=*sink:LOG. A full
|
|
|
|
description of the various debug levels can be found in the GStreamer core
|
|
|
|
library API documentation, in the "Running GStreamer Applications" section.
|
2003-09-29 22:02:41 +00:00
|
|
|
|
|
|
|
Use \-\-gst\-debug\-help to show category names
|
|
|
|
|
|
|
|
Example:
|
2005-12-17 14:19:27 +00:00
|
|
|
GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5
|
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.TP 8
|
2003-07-12 21:51:21 +00:00
|
|
|
.B \-\-gst\-debug\-level=LEVEL
|
|
|
|
Sets the threshold for printing debugging messages. A higher level
|
2013-01-18 16:01:11 +00:00
|
|
|
will print more messages. The useful range is 0-9, with the default
|
|
|
|
being 0. Level 6 (LOG level) will show all information that is usually
|
|
|
|
required for debugging purposes. Higher levels are only useful in very
|
2013-01-18 16:05:09 +00:00
|
|
|
specific cases. See above for the full list of levels.
|
2003-07-12 21:51:21 +00:00
|
|
|
.TP 8
|
|
|
|
.B \-\-gst\-debug\-no\-color
|
|
|
|
\fIGStreamer\fP normally prints debugging messages so that the
|
|
|
|
messages are color-coded when printed to a terminal that handles
|
2003-12-05 12:32:06 +00:00
|
|
|
ANSI escape sequences. Using this option causes \fIGStreamer\fP
|
2005-12-17 14:19:27 +00:00
|
|
|
to print messages without color. Setting the \fBGST_DEBUG_NO_COLOR\fR
|
|
|
|
environment variable will achieve the same thing.
|
2003-07-12 21:51:21 +00:00
|
|
|
.TP 8
|
2013-07-18 11:10:10 +00:00
|
|
|
.B \-\-gst\-debug\-color\-mode
|
|
|
|
\fIGStreamer\fP normally prints debugging messages so that the
|
|
|
|
messages are color-coded when printed to a terminal that handles
|
|
|
|
ANSI escape sequences (on *nix), or uses W32 console API to color the
|
|
|
|
messages printed into a console (on W32). Using this option causes
|
|
|
|
\fIGStreamer\fP to print messages without color ('off' or 'disable'),
|
|
|
|
print messages with default colors ('on' or 'auto'), or print messages
|
|
|
|
using ANSI escape sequences for coloring ('unix'). Setting the
|
|
|
|
\fBGST_DEBUG_COLOR_MODE\fR environment variable will achieve the same thing.
|
|
|
|
.TP 8
|
2009-03-24 21:39:21 +00:00
|
|
|
.B \-\-gst\-debug\-disable
|
2003-07-12 21:51:21 +00:00
|
|
|
Disables debugging.
|
|
|
|
.TP 8
|
|
|
|
.B \-\-gst\-debug\-help
|
|
|
|
Prints a list of available debug categories and their default debugging level.
|
|
|
|
.TP 8
|
2003-04-25 20:15:54 +00:00
|
|
|
.B \-\-gst\-plugin\-spew
|
|
|
|
\fIGStreamer\fP info flags to set
|
|
|
|
Enable printout of errors while loading \fIGStreamer\fP plugins
|
|
|
|
.TP 8
|
|
|
|
.B \-\-gst\-plugin\-path=PATH
|
|
|
|
Add directories separated with ':' to the plugin search path
|
|
|
|
.TP 8
|
|
|
|
.B \-\-gst\-plugin\-load=PLUGINS
|
|
|
|
Preload plugins specified in a comma-separated list. Another way to specify
|
|
|
|
plugins to preload is to use the environment variable GST_PLUGIN_PATH
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.SH "PIPELINE DESCRIPTION"
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2011-02-21 09:24:45 +00:00
|
|
|
A pipeline consists \fIelements\fR and \fIlinks\fR. \fIElements\fR can be put
|
2003-04-25 20:15:54 +00:00
|
|
|
into \fIbins\fR of different sorts. \fIElements\fR, \fIlinks\fR and \fIbins\fR
|
|
|
|
can be specified in a pipeline description in any order.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Elements
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
ELEMENTTYPE \fI[PROPERTY1 ...]\fR
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
Creates an element of type ELEMENTTYPE and sets the PROPERTIES.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Properties
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
PROPERTY=VALUE ...
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-03 09:30:53 +00:00
|
|
|
Sets the property to the specified value. You can use \fBgst\-inspect\-1.0\fR(1) to
|
2003-04-25 20:15:54 +00:00
|
|
|
find out about properties and allowed values of different elements.
|
|
|
|
.br
|
|
|
|
Enumeration properties can be set by name, nick or value.
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Bins
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
\fI[BINTYPE.]\fR ( \fI[PROPERTY1 ...]\fR PIPELINE-DESCRIPTION )
|
|
|
|
.br
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2011-02-21 09:24:45 +00:00
|
|
|
Specifies that a bin of type BINTYPE is created and the given properties are
|
2005-12-17 14:19:27 +00:00
|
|
|
set. Every element between the braces is put into the bin. Please note the dot
|
|
|
|
that has to be used after the BINTYPE. You will almost never need this
|
|
|
|
functionality, it is only really useful for applications using the
|
|
|
|
gst_launch_parse() API with 'bin' as bintype. That way it is possible to build
|
|
|
|
partial pipelines instead of a full-fledged top-level pipeline.
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Links
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
\fI[[SRCELEMENT].[PAD1,...]]\fR ! \fI[[SINKELEMENT].[PAD1,...]]\fR
|
2003-05-18 02:46:42 +00:00
|
|
|
\fI[[SRCELEMENT].[PAD1,...]]\fR ! CAPS ! \fI[[SINKELEMENT].[PAD1,...]]\fR
|
2015-06-25 17:29:27 +00:00
|
|
|
\fI[[SRCELEMENT].[PAD1,...]]\fR : \fI[[SINKELEMENT].[PAD1,...]]\fR
|
|
|
|
\fI[[SRCELEMENT].[PAD1,...]]\fR : CAPS : \fI[[SINKELEMENT].[PAD1,...]]\fR
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-05-18 02:46:42 +00:00
|
|
|
Links the element with name SRCELEMENT to the element with name SINKELEMENT,
|
|
|
|
using the caps specified in CAPS as a filter.
|
2003-04-25 20:15:54 +00:00
|
|
|
Names can be set on elements with the name property. If the name is omitted, the
|
|
|
|
element that was specified directly in front of or after the link is used. This
|
|
|
|
works across bins. If a padname is given, the link is done with these pads. If
|
|
|
|
no pad names are given all possibilities are tried and a matching pad is used.
|
|
|
|
If multiple padnames are given, both sides must have the same number of pads
|
|
|
|
specified and multiple links are done in the given order.
|
|
|
|
.br
|
|
|
|
So the simplest link is a simple exclamation mark, that links the element to
|
|
|
|
the left of it to the element right of it.
|
|
|
|
.br
|
2015-06-25 17:29:27 +00:00
|
|
|
Linking using the : operator attempts to link all possible pads between
|
|
|
|
the elements
|
|
|
|
.br
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-05-18 02:46:42 +00:00
|
|
|
.B Caps
|
|
|
|
|
2012-09-25 15:06:45 +00:00
|
|
|
MEDIATYPE \fI[, PROPERTY[, PROPERTY ...]]]\fR \fI[; CAPS[; CAPS ...]]\fR
|
2003-05-18 02:46:42 +00:00
|
|
|
|
2012-09-25 15:06:45 +00:00
|
|
|
Creates a capability with the given media type and optionally with given
|
|
|
|
properties. The media type can be escaped using " or '.
|
2003-05-18 02:46:42 +00:00
|
|
|
If you want to chain caps, you can add more caps in the same format afterwards.
|
|
|
|
|
|
|
|
.B Properties
|
|
|
|
|
2008-12-09 09:00:57 +00:00
|
|
|
NAME=\fI[(TYPE)]\fRVALUE
|
2003-05-18 02:46:42 +00:00
|
|
|
.br
|
2008-12-09 09:00:57 +00:00
|
|
|
in lists and ranges: \fI[(TYPE)]\fRVALUE
|
2003-05-18 02:46:42 +00:00
|
|
|
|
2006-03-22 09:03:10 +00:00
|
|
|
Sets the requested property in capabilities. The name is an alphanumeric value
|
2003-05-18 02:46:42 +00:00
|
|
|
and the type can have the following case-insensitive values:
|
|
|
|
.br
|
|
|
|
- \fBi\fR or \fBint\fR for integer values or ranges
|
|
|
|
.br
|
|
|
|
- \fBf\fR or \fBfloat\fR for float values or ranges
|
|
|
|
.br
|
|
|
|
- \fBb\fR, \fBbool\fR or \fBboolean\fR for boolean values
|
|
|
|
.br
|
|
|
|
- \fBs\fR, \fBstr\fR or \fBstring\fR for strings
|
|
|
|
.br
|
2016-11-02 21:36:27 +00:00
|
|
|
- \fBfraction\fR for fractions (framerate, pixel\-aspect\-ratio)
|
2005-12-17 14:19:27 +00:00
|
|
|
.br
|
2003-05-18 02:46:42 +00:00
|
|
|
- \fBl\fR or \fBlist\fR for lists
|
|
|
|
.br
|
2011-02-21 09:24:45 +00:00
|
|
|
If no type was given, the following order is tried: integer, float, boolean,
|
2003-05-18 02:46:42 +00:00
|
|
|
string.
|
|
|
|
.br
|
2003-05-18 04:40:19 +00:00
|
|
|
Integer values must be parsable by \fBstrtol()\fP, floats by \fBstrtod()\fP. FOURCC values may
|
2011-02-21 09:24:45 +00:00
|
|
|
either be integers or strings. Boolean values are (case insensitive) \fIyes\fR,
|
2003-05-18 02:46:42 +00:00
|
|
|
\fIno\fR, \fItrue\fR or \fIfalse\fR and may like strings be escaped with " or '.
|
|
|
|
.br
|
2008-12-09 09:00:57 +00:00
|
|
|
Ranges are in this format: [ VALUE, VALUE ]
|
2003-05-18 02:46:42 +00:00
|
|
|
.br
|
2012-09-18 13:22:03 +00:00
|
|
|
Lists use this format: { VALUE \fI[, VALUE ...]\fR }
|
2003-05-18 02:46:42 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.SH "PIPELINE EXAMPLES"
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
The examples below assume that you have the correct plug-ins available.
|
2016-04-06 14:46:20 +00:00
|
|
|
In general, "pulsesink" can be substituted with another audio output
|
|
|
|
plug-in such as "alsasink" or "osxaudiosink"
|
|
|
|
Likewise, "xvimagesink" can be substituted with "ximagesink", "glimagesink",
|
|
|
|
or "osxvideosink". Keep in mind though that different sinks might
|
2005-12-17 14:19:27 +00:00
|
|
|
accept different formats and even the same sink might accept different formats
|
|
|
|
on different machines, so you might need to add converter elements like
|
2012-09-13 09:35:41 +00:00
|
|
|
audioconvert and audioresample (for audio) or videoconvert (for video)
|
2005-12-17 14:19:27 +00:00
|
|
|
in front of the sink to make things work.
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Audio playback
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2017-03-20 16:54:22 +00:00
|
|
|
Play the mp3 music file "music.mp3" using a libmpg123-based plug-in and
|
2016-04-06 14:46:20 +00:00
|
|
|
output to an Pulseaudio device
|
2016-11-02 23:18:21 +00:00
|
|
|
.br
|
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! audioresample ! pulsesink
|
2003-04-25 20:15:54 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play an Ogg Vorbis format file
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.ogg ! oggdemux ! vorbisdec ! audioconvert ! audioresample ! pulsesink
|
2003-04-25 20:15:54 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play an mp3 file or an http stream using GIO
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 giosrc location=music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink
|
2003-04-25 20:15:54 +00:00
|
|
|
.br
|
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 giosrc location=http://domain.com/music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! audioresample ! pulsesink
|
2003-04-25 20:15:54 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Use GIO to play an mp3 file located on an SMB server
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 giosrc location=smb://computer/music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! audioresample ! pulsesink
|
2002-09-06 20:46:41 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Format conversion
|
2002-09-06 20:46:41 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Convert an mp3 music file to an Ogg Vorbis file
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! vorbisenc ! oggmux ! filesink location=music.ogg
|
2002-09-06 20:46:41 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Convert to the FLAC format
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! flacenc ! filesink location=test.flac
|
2002-09-06 20:46:41 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Other
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Plays a .WAV file that contains raw audio data (PCM).
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.wav ! wavparse ! audioconvert ! audioresample ! pulsesink
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Convert a .WAV file containing raw audio data into an Ogg Vorbis or mp3 file
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.wav ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location=music.ogg
|
2003-04-25 20:15:54 +00:00
|
|
|
.br
|
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=music.wav ! wavparse ! audioconvert ! lamemp3enc ! filesink location=music.mp3
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Rips all tracks from compact disc and convert them into a single mp3 file
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 cdparanoiasrc mode=continuous ! audioconvert ! lamemp3enc ! mpegaudioparse ! id3v2mux ! filesink location=cd.mp3
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Rips track 5 from the CD and converts it into a single mp3 file
|
|
|
|
.br
|
2009-05-25 22:58:37 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 cdparanoiasrc track=5 ! audioconvert ! lamemp3enc ! mpegaudioparse ! id3v2mux ! filesink location=track5.mp3
|
2009-05-25 22:58:37 +00:00
|
|
|
|
2016-11-03 09:30:53 +00:00
|
|
|
Using \fBgst\-inspect\-1.0\fR(1), it is possible to discover settings like the above
|
2009-05-25 22:58:37 +00:00
|
|
|
for cdparanoiasrc that will tell it to rip the entire cd or only tracks of it.
|
2016-11-03 09:30:53 +00:00
|
|
|
Alternatively, you can use an URI and gst\-launch\-1.0 will find an element (such as
|
2009-05-25 22:58:37 +00:00
|
|
|
cdparanoia) that supports that protocol for you, e.g.:
|
2005-12-17 14:19:27 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 cdda://5 ! lamemp3enc vbr=new vbr\-quality=6 ! filesink location=track5.mp3
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Records sound from your audio input and encodes it into an ogg file
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 pulsesrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=input.ogg
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-02-01 22:38:08 +00:00
|
|
|
.B Video
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-02-01 22:38:08 +00:00
|
|
|
Display only the video portion of an MPEG-1 video file, outputting to
|
2003-04-25 20:15:54 +00:00
|
|
|
an X display window
|
|
|
|
.br
|
2016-11-02 23:18:21 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpegvideoparse ! mpeg2dec ! xvimagesink
|
2016-11-02 23:18:21 +00:00
|
|
|
|
2003-02-01 22:38:08 +00:00
|
|
|
Display the video portion of a .vob file (used on DVDs), outputting to
|
2003-04-25 20:15:54 +00:00
|
|
|
an SDL window
|
2016-11-02 23:18:21 +00:00
|
|
|
.br
|
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=/flflfj.vob ! dvddemux ! mpegvideoparse ! mpeg2dec ! sdlvideosink
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play both video and audio portions of an MPEG movie
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=movie.mpg ! dvddemux name=demuxer demuxer. ! queue ! mpegvideoparse ! mpeg2dec ! sdlvideosink demuxer. ! queue ! mpegaudioparse ! mpg123audiodec ! audioconvert ! audioresample ! pulsesink
|
2003-02-01 22:38:08 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play an AVI movie with an external text subtitle stream
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2017-03-20 16:54:22 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=movie.mpg ! mpegdemux name=demuxer demuxer. ! queue ! mpegvideoparse ! mpeg2dec ! videoconvert ! sdlvideosink demuxer. ! queue ! mpegaudioparse ! mpg123audiodec ! audioconvert ! audioresample ! pulsesink
|
2009-11-03 01:18:42 +00:00
|
|
|
|
|
|
|
This example also shows how to refer to specific pads by name if an element
|
|
|
|
(here: textoverlay) has multiple sink or source pads.
|
2016-11-02 23:18:21 +00:00
|
|
|
.br
|
2009-11-03 01:18:42 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 textoverlay name=overlay ! videoconvert ! videoscale ! autovideosink filesrc location=movie.avi ! decodebin ! videoconvert ! overlay.video_sink filesrc location=movie.srt ! subparse ! overlay.text_sink
|
2009-11-03 01:18:42 +00:00
|
|
|
|
2014-04-03 05:36:03 +00:00
|
|
|
Play an AVI movie with an external text subtitle stream using playbin
|
2016-11-02 23:18:21 +00:00
|
|
|
.br
|
2009-11-03 01:18:42 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 playbin uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt
|
2003-02-01 22:38:08 +00:00
|
|
|
|
|
|
|
.B Network streaming
|
|
|
|
|
2007-02-02 12:27:16 +00:00
|
|
|
Stream video using RTP and network elements.
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
This command would be run on the transmitter
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 v4l2src ! video/x\-raw,width=128,height=96,format=UYVY ! videoconvert ! ffenc_h263 ! video/x\-h263 ! rtph263ppay pt=96 ! udpsink host=192.168.1.1 port=5000
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Use this command on the receiver
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 udpsrc port=5000 ! application/x\-rtp, clock\-rate=90000,payload=96 ! rtph263pdepay queue\-delay=0 ! ffdec_h263 ! xvimagesink
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2003-02-01 22:38:08 +00:00
|
|
|
.B Diagnostic
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Generate a null stream and ignore it (and print out details).
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 \-v fakesrc num\-buffers=16 ! fakesink
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Generate a pure sine tone to test the audio output
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 audiotestsrc ! audioconvert ! audioresample ! pulsesink
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Generate a familiar test pattern to test the video output
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 videotestsrc ! xvimagesink
|
2005-12-17 14:19:27 +00:00
|
|
|
.br
|
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 videotestsrc ! ximagesink
|
2001-12-13 23:24:11 +00:00
|
|
|
|
2003-04-25 20:15:54 +00:00
|
|
|
.B Automatic linking
|
2001-07-24 20:05:27 +00:00
|
|
|
|
2005-12-17 14:19:27 +00:00
|
|
|
You can use the decodebin element to automatically select the right elements
|
|
|
|
to get a working pipeline.
|
2002-01-07 20:50:32 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play any supported audio format
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=musicfile ! decodebin ! audioconvert ! audioresample ! pulsesink
|
2003-04-25 20:15:54 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Play any supported video format with video and audio output. Threads are used
|
|
|
|
automatically. To make this even easier, you can use the playbin element:
|
|
|
|
.br
|
2003-04-25 20:15:54 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 filesrc location=videofile ! decodebin name=decoder decoder. ! queue ! audioconvert ! audioresample ! pulsesink decoder. ! videoconvert ! xvimagesink
|
2003-04-25 20:15:54 +00:00
|
|
|
.br
|
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 playbin uri=file:///home/joe/foo.avi
|
2011-02-21 09:24:45 +00:00
|
|
|
|
2002-01-07 20:50:32 +00:00
|
|
|
|
2003-05-18 02:46:42 +00:00
|
|
|
.B Filtered connections
|
|
|
|
|
|
|
|
These examples show you how to use filtered caps.
|
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Show a test image and use the YUY2 or YV12 video format for this.
|
|
|
|
.br
|
2003-05-18 02:46:42 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 videotestsrc ! 'video/x\-raw,format=YUY2;video/x\-raw,format=YV12' ! xvimagesink
|
2003-05-18 02:46:42 +00:00
|
|
|
|
2016-11-02 23:18:21 +00:00
|
|
|
Record audio and write it to a .wav file. Force usage of signed 16 to 32 bit
|
|
|
|
samples and a sample rate between 32kHz and 64KHz.
|
|
|
|
.br
|
2003-05-18 02:46:42 +00:00
|
|
|
.B
|
2016-11-03 09:30:53 +00:00
|
|
|
gst\-launch\-1.0 pulsesrc ! 'audio/x\-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' ! wavenc ! filesink location=recording.wav
|
2005-12-17 14:19:27 +00:00
|
|
|
|
|
|
|
|
|
|
|
.SH "ENVIRONMENT VARIABLES"
|
|
|
|
.TP
|
|
|
|
\fBGST_DEBUG\fR
|
2013-02-13 23:27:16 +00:00
|
|
|
Comma-separated list of debug categories and levels (e.g.
|
|
|
|
GST_DEBUG=totem:4,typefind:5). '*' is allowed as a wildcard as part of
|
|
|
|
debug category names (e.g. GST_DEBUG=*sink:6,*audio*:6). Since 1.2.0 it is
|
|
|
|
also possible to specify the log level by name (1=ERROR, 2=WARN, 3=FIXME,
|
|
|
|
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP) (e.g. GST_DEBUG=*audio*:LOG)
|
2005-12-17 14:19:27 +00:00
|
|
|
.TP
|
|
|
|
\fBGST_DEBUG_NO_COLOR\fR
|
|
|
|
When this environment variable is set, coloured debug output is disabled.
|
|
|
|
.TP
|
2008-04-25 13:09:40 +00:00
|
|
|
\fBGST_DEBUG_DUMP_DOT_DIR\fR
|
2013-02-13 23:27:16 +00:00
|
|
|
When set to a filesystem path, store 'dot' files of pipeline graphs there.
|
|
|
|
These can then later be converted into an image using the 'dot' utility from
|
2016-11-02 21:36:27 +00:00
|
|
|
the graphviz set of tools, like this: dot foo.dot \-Tsvg \-o foo.svg (png or jpg
|
2015-10-16 14:59:49 +00:00
|
|
|
are also possible as output format). There is also a utility called 'xdot'
|
|
|
|
which allows you to view the .dot file directly without converting it first.
|
2017-06-11 15:15:13 +00:00
|
|
|
.br
|
|
|
|
When the pipeline changes state through NULL to PLAYING and back to NULL, a
|
|
|
|
dot file is generated on each state change. To write a snapshot of the
|
|
|
|
pipeline state, send a SIGHUP to the process.
|
2008-04-25 13:09:40 +00:00
|
|
|
.TP
|
2005-12-17 14:19:27 +00:00
|
|
|
\fBGST_REGISTRY\fR
|
2007-05-02 17:09:30 +00:00
|
|
|
Path of the plugin registry file. Default is
|
2016-11-03 09:30:53 +00:00
|
|
|
~/.cache/gstreamer\-1.0/registry\-CPU.bin where CPU is the
|
2016-11-02 21:56:01 +00:00
|
|
|
machine/cpu type GStreamer was compiled for, e.g. 'i486', 'i686', 'x86\-64', 'ppc',
|
|
|
|
etc. (check the output of "uname \-i" and "uname \-m" for details).
|
2005-12-17 14:19:27 +00:00
|
|
|
.TP
|
2008-08-18 11:28:00 +00:00
|
|
|
\fBGST_REGISTRY_UPDATE\fR
|
|
|
|
Set to "no" to force GStreamer to assume that no plugins have changed,
|
|
|
|
been added or been removed. This will make GStreamer skip the initial check
|
|
|
|
whether a rebuild of the registry cache is required or not. This may be useful
|
|
|
|
in embedded environments where the installed plugins never change. Do not
|
|
|
|
use this option in any other setup.
|
|
|
|
.TP
|
2005-12-17 14:19:27 +00:00
|
|
|
\fBGST_PLUGIN_PATH\fR
|
2006-01-12 16:31:35 +00:00
|
|
|
Specifies a list of directories to scan for additional plugins.
|
|
|
|
These take precedence over the system plugins.
|
2005-12-17 14:19:27 +00:00
|
|
|
.TP
|
|
|
|
\fBGST_PLUGIN_SYSTEM_PATH\fR
|
2011-02-21 09:24:45 +00:00
|
|
|
Specifies a list of plugins that are always loaded by default. If not set,
|
2006-01-12 16:31:35 +00:00
|
|
|
this defaults to the system-installed path, and the plugins installed in the
|
|
|
|
user's home directory
|
2005-12-17 14:19:27 +00:00
|
|
|
.TP
|
2012-11-06 17:29:28 +00:00
|
|
|
\fBGST_DEBUG_FILE\fR
|
|
|
|
Set this variable to a file path to redirect all GStreamer debug
|
|
|
|
messages to this file. If left unset, debug messages with be output
|
|
|
|
unto the standard error.
|
|
|
|
.TP
|
2010-08-24 19:46:38 +00:00
|
|
|
\fBORC_CODE\fR
|
|
|
|
Useful Orc environment variable. Set ORC_CODE=debug to enable debuggers
|
|
|
|
such as gdb to create useful backtraces from Orc-generated code. Set
|
|
|
|
ORC_CODE=backup or ORC_CODE=emulate if you suspect Orc's SIMD code
|
|
|
|
generator is producing incorrect code. (Quite a few important
|
|
|
|
GStreamer plugins like videotestsrc, audioconvert or audioresample use Orc).
|
|
|
|
.TP
|
2005-12-17 14:19:27 +00:00
|
|
|
\fBG_DEBUG\fR
|
|
|
|
Useful GLib environment variable. Set G_DEBUG=fatal_warnings to make
|
|
|
|
GStreamer programs abort when a critical warning such as an assertion failure
|
|
|
|
occurs. This is useful if you want to find out which part of the code caused
|
|
|
|
that warning to be triggered and under what circumstances. Simply set G_DEBUG
|
|
|
|
as mentioned above and run the program in gdb (or let it core dump). Then get
|
|
|
|
a stack trace in the usual way.
|
2001-03-16 01:06:50 +00:00
|
|
|
.
|
2006-03-21 15:04:20 +00:00
|
|
|
.SH FILES
|
|
|
|
.TP 8
|
2016-11-03 09:30:53 +00:00
|
|
|
~/.cache/gstreamer\-1.0/registry\-*.bin
|
2011-06-04 14:22:06 +00:00
|
|
|
The plugin cache; can be deleted at any time, will be re-created
|
2012-08-18 20:42:23 +00:00
|
|
|
automatically when it does not exist yet or plugins change. Based on
|
|
|
|
XDG_CACHE_DIR, so may be in a different location than the one suggested.
|
2006-03-21 15:04:20 +00:00
|
|
|
.
|
2001-07-24 20:05:27 +00:00
|
|
|
.SH "SEE ALSO"
|
2016-11-03 09:30:53 +00:00
|
|
|
.BR gst\-inspect\-1.0 (1),
|
|
|
|
.BR gst\-launch\-1.0 (1),
|
2001-07-24 20:05:27 +00:00
|
|
|
.SH "AUTHOR"
|
2005-12-17 14:19:27 +00:00
|
|
|
The GStreamer team at http://gstreamer.freedesktop.org/
|