diff --git a/tools/BUGS b/tools/BUGS index 15fb8ca45e..d43cee7767 100644 --- a/tools/BUGS +++ b/tools/BUGS @@ -1 +1 @@ -gstreamer-launch should not crash with bad options +gst-launch should not crash with bad options diff --git a/tools/README b/tools/README index 54a8aa61e2..792413907c 100644 --- a/tools/README +++ b/tools/README @@ -1,4 +1,4 @@ -gstreamer-launch +gst-launch ================ This is a tool that will construct pipelines based on a command-line @@ -8,125 +8,125 @@ 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 ! disksink 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 ! vorbisdec ! 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 ! 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 + gst-launch filesrc location=music.wav ! parsewav ! vorbisenc ! disksink location=music.ogg + gst-launch filesrc location=music.wav ! parsewav ! mpegaudio ! disksink 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 ! disksink 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 ! disksink 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): - gstreamer-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.audio_00! { queue ! mad ! osssink } + 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): - gstreamer-launch filesrc location=video.mpg ! mpegdemux video_00! { queue ! mpeg2dec ! sdlvideosink } mpegdemux0.audio_00! { queue ! mad ! osssink } + 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 ! a52dec ! 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): - gstreamer-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.private_stream_1.0! { queue ! a52dec ! osssink } + 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! For an avi file (DivX, mjpeg,...) - gstreamer-launch filesrc location=video.avi ! avidecoder video_00! { queue ! sdlvideosink } avidecoder0.audio_00! { queue ! osssink } + gst-launch filesrc location=video.avi ! avidecoder video_00! { queue ! sdlvideosink } avidecoder0.audio_00! { queue ! osssink } -gstreamer-complete +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 +gst-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 +files into memory at startup. As with gst-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 + ./gst-inspect shows more info about the plugin/element. diff --git a/tools/gst-register.c b/tools/gst-register.c index 32540f417c..56bb937d28 100644 --- a/tools/gst-register.c +++ b/tools/gst-register.c @@ -2,7 +2,7 @@ * Copyright (C) 1999,2000 Erik Walthinsen * 2000 Wim Taymans * - * gstreamer-register.c: Plugin subsystem for loading elements, types, and libs + * gst-register.c: Plugin subsystem for loading elements, types, and libs * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public