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 disksrc location=music.mp3 ! mad ! osssink
13 This plays an mp3 music file music.mp3 using libmad, and:
15 gstreamer-launch disksrc 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 disksrc location=music.mp3 ! mad ! vorbisenc ! disksink location=music.ogg
36 And then we can play that file with:
38 gstreamer-launch disksrc location=music.ogg ! vorbisdec ! osssink
40 Some other useful pipelines are..
41 Plays wav files (currently there are no wav encoders):
43 gstreamer-launch disksrc location=music.wav ! parsewav ! osssink
45 Converts wav files into mp3 and ogg files:
47 gstreamer-launch disksrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg
48 gstreamer-launch disksrc 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 disksrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
68 gstreamer-launch disksrc location=video.mpg ! mpegdemux audio_00! { queue ! mad ! osssink }
70 For mpeg2 files (video and audio streams respectively):
72 gstreamer-launch disksrc location=video.mpeg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
73 gstreamer-launch disksrc location=video.mpeg ! mpegdemux private_stream_1.0! { queue ! ac3dec ! osssink }
75 Note: The types of audio streams in the mpeg files can vary!
80 This is a simple utility which provides custom bash completion when
81 typing gstreamer-launch commands.
83 Simply run "gstreamer-compprep" as root to build the registry of completions,
84 and then put, in your .bashrc,
85 "complete -C gstreamer-complete gstreamer-launch"
86 (ensuring that gstreamer-complete is on your path).
88 You can then enjoy context sensitive tab-completion of gstreamer-launch
95 This tool will perform an introspection on all available plugins and will
96 create a registry file in /etc/gstreamer/reg.xml. Startup time will be
97 much faster since the gstreamer core doesn't have to bring all the plugins
98 files into memory at startup. As with gstreamer-compprep you need to run this
99 as root for it too work correctly.
105 Allows you to check the properties of plugins and elements.
109 will show all the plugins available and the elements they contain.
111 ./gstreamer-inspect <pluginname/elementname>
113 shows more info about the plugin/element.