REQUIREMENTS

   1 GStreamer uses a *large* array of tools and libraries, most of which are
   2 optional.  We have attempted to make sure that any code that depends on
   3 optional libraries doesn't get built unless you have those libraries.  If
   4 you find this not to be the case, please, let us know by filing a bug
   5 report at http://bugzilla.gnome.org/.
   6
   7
   8 Required tools:
   9 ===============
  10
  11 An extra set of tools is required if you wish to build GStreamer out of
  12 CVS (using autogen.sh):
  13
  14 autoconf 2.52 or better
  15 automake 1.5
  16 gettext 0.11.5
  17 libtool v1.4 or better
  18 pkgconfig 0.9.0 or better (http://www.freedesktop.org/software/pkgconfig/)
  19
  20 Required libraries:
  21 ===================
  22
  23 The core GStreamer libraries. See the gstreamer/ module in GStreamer cvs, or
  24 the version that corresponds to this plugin release.
  25
  26 Optional libraries:
  27 ===================
  28
  29 This file lists supporting libraries for which gst-plugins contains plugins,
  30 as well as their minimum version.  You can find the corresponding plugins in
  31 ext/(library)
  32
  33 dirac           (Dirac video codec)
  34                         http://www.bbc.co.uk/rd/projects/dirac/index.shtml
  35 libaudiofile    (for afsrc/afsink
  36                         http://oss.sgi.com/projects/audiofile/
  37 libmad          (for the mad mp3 decoder plugin)
  38                         http://www.mars.org/home/rob/proj/mpeg/
  39 libjpeg         (for jpegenc/jpegdec)
  40                         http://www.ijg.org/
  41 libopenquicktime (for the QT plugin)
  42                         http://sourceforge.net/projects/openquicktime/
  43 libXv           (for videosink)
  44 libxaudio       (for xa mp3 decoder)
  45                         http://www.xaudio.com/
  46 libvorbis       (for vorbisenc, vorbisdec)
  47                         http://www.xiph.org/ogg/vorbis/index.html
  48 libcdparanoia   (for cdparanoia ripper)
  49                         http://www.xiph.org/paranoia/index.html
  50 liblame         (for lame mp3 encoder)
  51                         http://www.mp3dev.org/mp3/
  52 libshout        (for the shoutcast plugin)
  53                         http://www.icecast.org
  54 libasound       (for the alsa src/sink plugin)
  55                         http://alsa-project.org/
  56 librtp          (for the rtp sink plugin)
  57                         http://www.linphone.org/ortp/
  58 aalib           (for the aa sink plugin)
  59                         http://aa-project.sourceforge.net/aalib/
  60 libcaca         (for the color aa sink plugin)
  61                         http://sam.zoy.org/projects/libcaca/
  62 aRts            (for the arts plugin wrapper, and the artsd sink)
  63                         http://www.arts-project.org
  64 raw1394/linux1394       (for the dv plugin)
  65                         http://linux1394.sourceforge.net
  66 libdvdread      (for the dvdsrc)
  67                         http://www.dtek.chalmers.se/groups/dvd/
  68                         (optional: libcss for encrypted DVDs)
  69 libdvdnav       (for the dvdnavsrc)
  70                         http://dvd.sourceforge.net/
  71                         (optional: libcss for encrypted DVDs)
  72                 >= 0.1.9
  73 libesound       (for the esd sink
  74                         ftp.gnome.org/pub/GNOME/stable/sources/esound)
  75 gnome-vfs       (for the gnome-vfs src)
  76                 >= 2.4.0
  77 libgsm          (for the gsm plugin)
  78                         http://kbs.cs.tu-berlin.de/~jutta/toast.html
  79 sdl             (for the sdl sink)
  80                         http://www.libsdl.org
  81 xmms            (for the xmms plugins wrapper)
  82                         http://www.xmms.org
  83 mpeg2dec/a52dec (for mpeg2 related plugins and dvd playback)
  84                         http://libmpeg2.sourceforge.net/
  85                         and http://liba52.sourceforge.net/
  86                 >=      v0.3.1/v0.7.2
  87 swfdec          (for the swfdec (flash) plugin)
  88                         http://www.schleef.org/swfdec/
  89 liboil          (for the liboil optimization library)
  90                         http://www.schleef.org/liboil/
  91                 >=      0.2.0
  92 flac            (for the FLAC lossless audio format)
  93                         http://flac.sourceforge.net
  94                 >= 1.0.3 preferred, 1.0.2 should work
  95 gtk             (for the gdk_pixbuf plugin)
  96                         http://www.gtk.org/
  97                 >= 2.2.1 preferred, 2.0 ok
  98 pango           (for the textoverlay plugins)
  99                         http://www.pango.org/
 100 libHermes       (for colorspace conversion;most use ffcolorspace instead)
 101                         http://www.clanlib.org/hermes/
 102 librfb          (for capturing of VNC output into a videostream)
 103                         http://www.schleef.org/
 104 libHermes       (for colorspace conversions (should not be needed anymore))
 105                         http://www.clanlib.org/hermes/
 106 dtsdec          (for DTS audio decoding)
 107                         http://www.videolan.org/libdca.html
 108 divx            (for divx decoding)
 109                         http://www.divx.com/divx/linux/
 110 libmng          (for mng animated image format encoding/decoding)
 111                         http://gjuyn.xs4all.nl/libmng
 112 libvisual       (for audio visualisations)
 113                         http://libvisual.sourceforge.net/v2/
 114 musepack        (for musepack audio codec/format)
 115                         (http://www.musepack.net/)
 116 nas             (for the NAS sound server sink)
 117                         (http://radscan.com/nas.html)
 118 libtheora       (for Ogg Theora video support)
 119                         (http://www.theora.org)
 120
 121
 122 Optional debian packages:
 123 =========================
 124
 125 gtk-doc-tools 0.4-0.2  -- needed to build documentation