gst-launch.1 3.71 KB
Newer Older
1
.TH "GStreamer" "1" "March 2001"
2
.SH "NAME"
3
gst\-launch \- build and run a GStreamer pipeline
4
.SH "SYNOPSIS"
5
\fBgst\-launch\fR \fI[OPTION...]\fR PIPELINE\-DESCRIPTION
6
7
.SH "DESCRIPTION"
.LP 
David I. Lehn's avatar
David I. Lehn committed
8
\fIgst\-launch\fP is a tool that is used to build and run a basic \fIGStreamer\fP pipeline.
9
10
11

A simple commandline looks like:

12
 gst\-launch filesrc location=music.mp3 ! mad ! osssink
13
14
15

This plays an mp3 music file music.mp3 using libmad, and:

16
 gst\-launch filesrc location=music.mp3 ! mp3parse ! mpg123 ! osssink
17
18
19
20
21

Plays and mp3 music file using mpg123

You can also stream files over http:

22
 gst\-launch httpsrc location=http://domain.com/music.mp3 ! mad ! osssink
23
24
25

And using gnome\-vfs you can do the same with:

26
27
 gst\-launch gnomevfssrc location=music.mp3 ! mad ! osssink
 gst\-launch gnomevfssrc location=http://domain.com/music.mp3 ! mad ! osssink
28
29
30

And too play the same song with gnome\-vfs via smb:

31
 gst\-launch gnomevfssrc location=smb://computer/music.mp3 ! mad ! osssink
32
33
34

Here we convert a Mp3 file into an Ogg Vorbis file:

35
 gst\-launch filesrc location=music.mp3 ! mad ! vorbisenc ! disksink location=music.ogg
36

37
Or converting from mp3 to Flac:
38
 gst\-launch filesrc location=claptrap.mp3 ! mad ! flacenc ! disksink location=test.flac
39

40
41
And then we can play that file with:

42
 gst\-launch filesrc location=music.ogg ! vorbisdec ! osssink
43
44
45
46

Some other useful pipelines are..
Plays wav files (currently there are no wav encoders):

47
 gst\-launch filesrc location=music.wav ! parsewav ! osssink
48
49
50

Converts wav files into mp3 and ogg files:

51
52
 gst\-launch filesrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg
 gst\-launch filesrc location=music.wav ! parsewav ! mpegaudio ! disksink location=music.mp3
53
54
55
56
57
58

You can also use lame for mp3 encoding if you have it installed, it does a 
much better job than mpegaudio.

Rips all songs from cd and saves them into a mp3 file:

59
 gst\-launch cdparanoia ! mpegaudio ! disksink location=cd.mp3
60

61
You can toy around with gst\-inspect to discover the settings for 
62
63
64
65
cdparanoia to rip individual tracks

Record sound from your sound input and encode it into an ogg file:

66
 gst\-launch osssrc ! vorbisenc ! disksink location=input.ogg
67

68
gst\-launch not only handles audio but video as well:
69
For mpeg video files (here outputing to aasink) :
70

71
 gst\-launch filesrc location=JB_FF9_TheGravityOfLove.mpg ! mpegdemux video_%02d! { queue ! mpeg2dec ! aasink }
72
73

For vob files (here outputting image to sdlvideosink): 
74
 gst\-launch filesrc location=/flflfj.vob ! mpegdemux video_%02d! { queue ! mpeg2dec ! sdlvideosink }
75

76
Play a mpeg movie with sound using the sdlvideosink:
77
 gst\-launch filesrc location=movie.mpg ! mpegdemux video_%02d! { queue ! mpeg2dec ! sdlvideosink } mpegdemux0.audio_%02d! { queue ! mad ! osssink }
78
79

Playing a avi movie would be done with something like this:
80
gst\-launch filesrc location=movie.avi ! avidemux video_%02d! { queue ! windec ! sdlvideosink }
81

David I. Lehn's avatar
David I. Lehn committed
82
83
84
See other docs, examples, and the source for description on how to
create a PIPELINE\-DESCRIPTION.
.
85
.SH "OPTIONS"
David I. Lehn's avatar
David I. Lehn committed
86
.l
87
\fIgst\-launch\fP accepts the following options:
David I. Lehn's avatar
David I. Lehn committed
88
89
90
91
92
93
94
95
96
97
.TP 8
.B  \-\-help
Print help synopsis and available FLAGS
.TP 8
.B  \-\-gst\-info\-mask=FLAGS
\fIGStreamer\fP info flags to set (list with \-\-help)
.TP 8
.B  \-\-gst\-debug\-mask=FLAGS
\fIGStreamer\fP debugging flags to set (list with \-\-help)
.TP 8
98
99
100
.B  \-\-gst\-mask=FLAGS
\fIGStreamer\fP info and debugging flags to set (list with \-\-help)
.TP 8
David I. Lehn's avatar
David I. Lehn committed
101
102
103
104
105
106
.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
107
.SH "SEE ALSO"
108
109
110
.BR gst\-complete (1),
.BR gst\-register (1),
.BR gst\-inspect (1),
111
.SH "AUTHOR"
David I. Lehn's avatar
David I. Lehn committed
112
The GStreamer team at http://gstreamer.net/