.TH "GStreamer" "1" "March 2001" .SH "NAME" gstreamer\-launch \- build and run a GStreamer pipeline .SH "SYNOPSIS" \fBgstreamer\-launch\fR \fI[OPTION...]\fR PIPELINE\-DESCRIPTION .SH "DESCRIPTION" .LP \fBgstreamer\-launch\fR is a tool that is used to build and run a basic <fl>GStreamer\fR pipeline. A simple commandline looks like: gstreamer\-launch filesrc location=music.mp3 ! mad ! osssink This plays an mp3 music file music.mp3 using libmad, and: gstreamer\-launch filesrc location=music.mp3 ! mp3parse ! mpg123 ! osssink Plays and mp3 music file using mpg123 You can also stream files over http: gstreamer\-launch httpsrc location=http://domain.com/music.mp3 ! mad ! osssink And using gnome\-vfs you can do the same with: gstreamer\-launch gnomevfssrc location=music.mp3 ! mad ! osssink gstreamer\-launch gnomevfssrc location=http://domain.com/music.mp3 ! mad ! osssink And too play the same song with gnome\-vfs via smb: gstreamer\-launch gnomevfssrc location=smb://computer/music.mp3 ! mad ! osssink Here we convert a Mp3 file into an Ogg Vorbis file: gstreamer\-launch filesrc location=music.mp3 ! mad ! vorbisenc ! disksink location=music.ogg Or converting from mp3 to Flac: gstreamer\-launch filesrc location=claptrap.mp3 ! mad ! flacenc ! disksink location=test.flac And then we can play that file with: gstreamer\-launch filesrc location=music.ogg ! vorbisdec ! osssink Some other useful pipelines are.. Plays wav files (currently there are no wav encoders): gstreamer\-launch filesrc location=music.wav ! parsewav ! osssink Converts wav files into mp3 and ogg files: gstreamer\-launch filesrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg gstreamer\-launch filesrc location=music.wav ! parsewav ! mpegaudio ! disksink location=music.mp3 Play mpeg movie with the aasink: gstreamer\-launch filesrc location=JB_FF9_TheGravityOfLove.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! aasink } 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: gstreamer\-launch cdparanoia ! mpegaudio ! disksink location=cd.mp3 You can toy around with gstreamer\-inspect to discover the settings for cdparanoia to rip individual tracks Record sound from your sound input and encode it into an ogg file: gstreamer\-launch osssrc ! vorbisenc ! disksink location=input.ogg gstreamer\-launch not only handles audio but video as well: For mpeg video files (here outputing to aasink) : gstreamer\-launch filesrc location=JB_FF9_TheGravityOfLove.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! aasink } For vob files (here outputting image to sdlvideosink): gstreamer\-launch filesrc location=/flflfj.vob ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink } See other docs, examples, and the source for description on how to create a PIPELINE\-DESCRIPTION. . .SH "OPTIONS" .l \fIgstreamer\-launch\fP accepts the following options: .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 .B \-\-gst\-mask=FLAGS \fIGStreamer\fP info and debugging flags to set (list with \-\-help) .TP 8 .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 .SH "SEE ALSO" .BR gstreamer\-guilaunch (1), .BR gstreamer\-complete (1), .BR gstreamer\-register (1), .BR gstreamer\-inspect (1), .BR gstreamer\-config (1) .SH "AUTHOR" The GStreamer team at http://gstreamer.net/