tools/gst-launch.1

   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 .SH "DESCRIPTION"
   7 .LP
   8 \fIgst\-launch\fP is a tool that is used to build and run a basic \fIGStreamer\fP pipeline.
   9
  10 A simple commandline looks like:
  11
  12  gst\-launch filesrc location=music.mp3 ! mad ! osssink
  13
  14 This plays an mp3 music file music.mp3 using libmad, and:
  15
  16  gst\-launch filesrc location=music.mp3 ! mp3parse ! mpg123 ! osssink
  17
  18 Plays and mp3 music file using mpg123
  19
  20 You can also stream files over http:
  21
  22  gst\-launch httpsrc location=http://domain.com/music.mp3 ! mad ! osssink
  23
  24 And using gnome\-vfs you can do the same with:
  25
  26  gst\-launch gnomevfssrc location=music.mp3 ! mad ! osssink
  27  gst\-launch gnomevfssrc location=http://domain.com/music.mp3 ! mad ! osssink
  28
  29 And too play the same song with gnome\-vfs via smb:
  30
  31  gst\-launch gnomevfssrc location=smb://computer/music.mp3 ! mad ! osssink
  32
  33 Here we convert a Mp3 file into an Ogg Vorbis file:
  34
  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 And then we can play that file with:
  41
  42  gst\-launch filesrc location=music.ogg ! vorbisdec ! osssink
  43
  44 Some other useful pipelines are..
  45 Plays wav files (currently there are no wav encoders):
  46
  47  gst\-launch filesrc location=music.wav ! parsewav ! osssink
  48
  49 Converts wav files into mp3 and ogg files:
  50
  51  gst\-launch filesrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg
  52  gst\-launch filesrc location=music.wav ! parsewav ! mpegaudio ! disksink location=music.mp3
  53
  54 You can also use lame for mp3 encoding if you have it installed, it does a
  55 much better job than mpegaudio.
  56
  57 Rips all songs from cd and saves them into a mp3 file:
  58
  59  gst\-launch cdparanoia ! mpegaudio ! disksink location=cd.mp3
  60
  61 You can toy around with gst\-inspect to discover the settings for
  62 cdparanoia to rip individual tracks
  63
  64 Record sound from your sound input and encode it into an ogg file:
  65
  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_00! { queue ! mpeg2dec ! aasink }
  72
  73 For vob files (here outputting image to sdlvideosink):
  74  gst\-launch filesrc location=/flflfj.vob ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
  75
  76 Play a mpeg movie with sound using the sdlvideosink:
  77  gst\-launch filesrc location=movie.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink } mpegdemux0.audio_00! { 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_00! { queue ! windec ! sdlvideosink }
  81
  82 See other docs, examples, and the source for description on how to
  83 create a PIPELINE\-DESCRIPTION.
  84 .
  85 .SH "OPTIONS"
  86 .l
  87 \fIgst\-launch\fP accepts the following options:
  88 .TP 8
  89 .B  \-\-help
  90 Print help synopsis and available FLAGS
  91 .TP 8
  92 .B  \-\-gst\-info\-mask=FLAGS
  93 \fIGStreamer\fP info flags to set (list with \-\-help)
  94 .TP 8
  95 .B  \-\-gst\-debug\-mask=FLAGS
  96 \fIGStreamer\fP debugging flags to set (list with \-\-help)
  97 .TP 8
  98 .B  \-\-gst\-mask=FLAGS
  99 \fIGStreamer\fP info and debugging flags to set (list with \-\-help)
 100 .TP 8
 101 .B  \-\-gst\-plugin\-spew
 102 \fIGStreamer\fP info flags to set
 103 Enable printout of errors while loading \fIGStreamer\fP plugins
 104 .TP 8
 105 .B  \-\-gst\-plugin\-path=PATH
 106 Add directories separated with ':' to the plugin search path
 107 .SH "SEE ALSO"
 108 .BR gst\-guilaunch (1),
 109 .BR gst\-complete (1),
 110 .BR gst\-register (1),
 111 .BR gst\-inspect (1),
 112 .SH "AUTHOR"
 113 The GStreamer team at http://gstreamer.net/