Update NEWS and RELEASE as well
[platform/upstream/gstreamer.git] / tools / README
index a41c1f3..44ca744 100644 (file)
@@ -1,4 +1,4 @@
-gstreamer-launch
+gst-launch
 ================
 
 This is a tool that will construct pipelines based on a command-line
@@ -8,108 +8,127 @@ feedback pipelines are the most complex.
 
 A simple commandline looks like:
 
- gstreamer-launch filesrc location=music.mp3 ! mad ! osssink
+ gst-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
+ gst-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
+ gst-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
+ gst-launch gnomevfssrc location=music.mp3 ! mad ! osssink
+ gst-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
+ gst-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
+ gst-launch filesrc location=music.mp3 ! mad ! vorbisenc ! filesink location=music.ogg
 
 And then we can play that file with:
 
- gstreamer-launch filesrc location=music.ogg ! vorbisdec ! osssink
+ gst-launch filesrc location=music.ogg ! oggdemux ! vorbisdec ! audioconvert ! osssink
 
 Some other useful pipelines are..
 Plays wav files (currently there are no wav encoders):
 
- gstreamer-launch filesrc location=music.wav ! parsewav ! osssink
+ gst-launch filesrc location=music.wav ! wavparse ! 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
+ gst-launch filesrc location=music.wav ! wavparse ! vorbisenc ! filesink location=music.ogg
+ gst-launch filesrc location=music.wav ! wavparse ! mpegaudio ! filesink location=music.mp3
 
 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
+ gst-launch cdparanoia ! mpegaudio ! filesink location=cd.mp3
 
-You can toy around with gstreamer-inspect to discover the settings for 
+You can toy around with gst-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
+ gst-launch osssrc ! vorbisenc ! filesink location=input.ogg
 
-gstreamer-launch not only handles audio but video as well:
+gst-launch not only handles audio but video as well:
 For mpeg1 files (video and audio streams respectively):
 
- gstreamer-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
- gstreamer-launch filesrc location=video.mpg ! mpegdemux audio_00! { queue ! mad ! osssink }
+ gst-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
+ gst-launch filesrc location=video.mpg ! mpegdemux audio_00! { queue ! mad ! osssink }
+
+for mpeg1 with both audio and video (for glib2):
+
+ gst-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.audio_00! { queue ! mad ! osssink }
+
+for mpeg1 with both audio and video (for gtk1.2, the shim doesn't handle the 'name' property yet):
+
+ gst-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink } mpegdemux0.audio_00! { queue ! mad ! osssink }
 
 For mpeg2 files (video and audio streams respectively):
  
- gstreamer-launch filesrc location=video.mpeg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
- gstreamer-launch filesrc location=video.mpeg ! mpegdemux private_stream_1.0! { queue ! ac3dec ! osssink }
+ gst-launch filesrc location=video.mpeg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink }
+ gst-launch filesrc location=video.mpeg ! mpegdemux private_stream_1.0! { queue ! a52dec ! osssink }
+
+for mpeg2 with both audio and video (glib2):
+
+ gst-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.private_stream_1.0! { queue ! a52dec ! osssink }
 
 Note: The types of audio streams in the mpeg files can vary!
-gstreamer-complete
+
+For an avi file (DivX, mjpeg,...)
+
+ gst-launch filesrc location=video.avi ! avidecoder video_00! { queue ! sdlvideosink } avidecoder0.audio_00! { queue ! osssink }
+
+
+
+gst-complete
 ==================
 
 This is a simple utility which provides custom bash completion when
-typing gstreamer-launch commands. 
+typing gst-launch commands. 
 
-Simply run "gstreamer-compprep" as root to build the registry of completions,
+Simply run "gst-compprep" as root to build the registry of completions,
 and then put, in your .bashrc,
-"complete -C gstreamer-complete gstreamer-launch"
-(ensuring that gstreamer-complete is on your path).
+"complete -C gst-complete gst-launch"
+(ensuring that gst-complete is on your path).
 
-You can then enjoy context sensitive tab-completion of gstreamer-launch
+You can then enjoy context sensitive tab-completion of gst-launch
 commands.
 
 
-gstreamer-register
-==================
-
-This tool will perform an introspection on all available plugins and will
-create a registry file in /etc/gstreamer/reg.xml. Startup time will be
-much faster since the gstreamer core doesn't have to bring all the plugins 
-files into memory at startup. As with gstreamer-compprep you need to run this
-as root for it too work correctly.
 
-
-gstreamer-inspect
+gst-inspect
 =================
 
 Allows you to check the properties of plugins and elements.
 
- ./gstreamer-inspect 
+ ./gst-inspect 
  
 will show all the plugins available and the elements they contain.
 
- ./gstreamer-inspect <pluginname/elementname>
+ ./gst-inspect <pluginname/elementname>
 
 shows more info about the plugin/element.
 
 
+
+gst-xmlinspect
+=================
+
+Dump properties of plugins and elements in an xml format. You can 
+transform the xml to something else with an appropriate stylesheet.
+
+ ./gst-xmlinspect <elementname> | xsltproc xml2text.xsl -
+
+