4 This is a tool that will construct pipelines based on a command-line
5 syntax. The syntax is rather complex to enable all the features I want it
6 to have, but should be easy to use for most people. Multi-pathed and
7 feedback pipelines are the most complex.
9 A simple commandline looks like:
11 gstreamer-launch filesrc location=music.mp3 ! mad ! osssink
13 This plays an mp3 music file music.mp3 using libmad, and:
15 gstreamer-launch filesrc location=music.mp3 ! mp3parse ! mpg123 ! osssink
17 Plays and mp3 music file using mpg123
19 You can also stream files over http:
21 gstreamer-launch httpsrc location=http://domain.com/music.mp3 ! mad ! osssink
23 And using gnome-vfs you can do the same with:
25 gstreamer-launch gnomevfssrc location=music.mp3 ! mad ! osssink
26 gstreamer-launch gnomevfssrc location=http://domain.com/music.mp3 ! mad ! osssink
28 And too play the same song with gnome-vfs via smb:
30 gstreamer-launch gnomevfssrc location=smb://computer/music.mp3 ! mad ! osssink
32 Here we convert a Mp3 file into an Ogg Vorbis file:
34 gstreamer-launch filesrc location=music.mp3 ! mad ! vorbisenc ! disksink location=music.ogg
36 And then we can play that file with:
38 gstreamer-launch filesrc location=music.ogg ! vorbisdec ! osssink
40 Some other useful pipelines are..
41 Plays wav files (currently there are no wav encoders):
43 gstreamer-launch filesrc location=music.wav ! parsewav ! osssink
45 Converts wav files into mp3 and ogg files:
47 gstreamer-launch filesrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg
48 gstreamer-launch filesrc location=music.wav ! parsewav ! mpegaudio ! disksink location=music.mp3
50 You can also use lame for mp3 encoding if you have it installed, it does a
51 much better job than mpegaudio.
53 Rips all songs from cd and saves them into a mp3 file:
55 gstreamer-launch cdparanoia ! mpegaudio ! disksink location=cd.mp3
57 You can toy around with gstreamer-inspect to discover the settings for
58 cdparanoia to rip individual tracks
60 Record sound from your sound input and encode it into an ogg file:
62 gstreamer-launch osssrc ! vorbisenc ! disksink location=input.ogg
64 gstreamer-launch not only handles audio but video as well:
65 For mpeg1 files (video and audio streams respectively):
67 gstreamer-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
68 gstreamer-launch filesrc location=video.mpg ! mpegdemux audio_00! { queue ! mad ! osssink }
70 for mpeg1 with both audio and video (for glib2):
72 gstreamer-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.audio_00! { queue ! mad ! osssink }
74 for mpeg1 with both audio and video (for gtk1.2, the shim doesn't handle the 'name' property yet):
76 gstreamer-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink } mpegdemux0.audio_00! { queue ! mad ! osssink }
78 For mpeg2 files (video and audio streams respectively):
80 gstreamer-launch filesrc location=video.mpeg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
81 gstreamer-launch filesrc location=video.mpeg ! mpegdemux private_stream_1.0! { queue ! a52dec ! osssink }
83 for mpeg2 with both audio and video (glib2):
85 gstreamer-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.private_stream_1.0! { queue ! a52dec ! osssink }
87 Note: The types of audio streams in the mpeg files can vary!
89 For an avi file (DivX, mjpeg,...)
91 gstreamer-launch filesrc location=video.avi ! avidecoder video_00! { queue ! sdlvideosink } avidecoder0.audio_00! { queue ! osssink }
98 This is a simple utility which provides custom bash completion when
99 typing gstreamer-launch commands.
101 Simply run "gstreamer-compprep" as root to build the registry of completions,
102 and then put, in your .bashrc,
103 "complete -C gstreamer-complete gstreamer-launch"
104 (ensuring that gstreamer-complete is on your path).
106 You can then enjoy context sensitive tab-completion of gstreamer-launch
113 This tool will perform an introspection on all available plugins and will
114 create a registry file in /etc/gstreamer/reg.xml. Startup time will be
115 much faster since the gstreamer core doesn't have to bring all the plugins
116 files into memory at startup. As with gstreamer-compprep you need to run this
117 as root for it too work correctly.
123 Allows you to check the properties of plugins and elements.
127 will show all the plugins available and the elements they contain.
129 ./gstreamer-inspect <pluginname/elementname>
131 shows more info about the plugin/element.