gstreamer/tools
Andy Wingo 9ee758f076 output human-readable xml
Original commit message from CVS:
output human-readable xml
2001-12-26 06:58:25 +00:00
..
.gitignore new gui tool to launch pipelines in the same vein as gstreamer-launch. try it out, it rocks 2001-09-22 12:22:23 +00:00
BUGS guess what 2001-12-10 21:57:21 +00:00
gstreamer-complete.1 Add gstreamer-compprep man page. 2001-06-07 10:58:40 +00:00
gstreamer-complete.c ok, death to all // GCC only comments, we are going portable 2001-12-14 20:56:51 +00:00
gstreamer-compprep.1 Some formatting updates, thanks to using manedit 2001-06-10 21:13:12 +00:00
gstreamer-compprep.c output human-readable xml 2001-12-26 06:58:25 +00:00
gstreamer-guilaunch.1 guilaunch manpage 2001-12-11 23:52:58 +00:00
gstreamer-guilaunch.c ok, death to all // GCC only comments, we are going portable 2001-12-14 20:56:51 +00:00
gstreamer-inspect.1 added --gst-mask to the man pages 2001-06-07 00:08:56 +00:00
gstreamer-inspect.c ok, death to all // GCC only comments, we are going portable 2001-12-14 20:56:51 +00:00
gstreamer-launch.1 replacing disksrc with filesrc and adding some / which I think man wants 2001-12-14 23:25:07 +00:00
gstreamer-launch.c missing include 2001-12-24 22:57:32 +00:00
gstreamer-register.1 Add gstreamer-compprep man page. 2001-06-07 10:58:40 +00:00
gstreamer-register.c format the outputted reg.xml for libxml2. if anything causes your xml probs in the future, this is probably it... 2001-12-25 22:57:31 +00:00
Makefile.am removed gstreamer.m4 (packages should use pkg.m4) guilaunch depends only on gtk, not libglade-gnome removed an unnece... 2001-12-20 01:20:22 +00:00
README Some help for playing both audio in video with -launch 2001-12-17 14:24:26 +00:00

gstreamer-launch
================

This is a tool that will construct pipelines based on a command-line
syntax.  The syntax is rather complex to enable all the features I want it
to have, but should be easy to use for most people.  Multi-pathed and
feedback pipelines are the most complex.

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

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

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 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 }

for mpeg1 with both audio and video:

 gstreamer-launch filesrc location=video.mpg ! mpegdemux name=demux video_00! { queue ! mpeg2dec ! sdlvideosink } demux.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 }

for mpeg2 with both audio and video:

 gstreamer-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
==================

This is a simple utility which provides custom bash completion when
typing gstreamer-launch commands. 

Simply run "gstreamer-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).

You can then enjoy context sensitive tab-completion of gstreamer-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
=================

Allows you to check the properties of plugins and elements.

 ./gstreamer-inspect 
 
will show all the plugins available and the elements they contain.

 ./gstreamer-inspect <pluginname/elementname>

shows more info about the plugin/element.