tiny cosmetic changes
[platform/upstream/gstreamer.git] / 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 libHermes       (for colorspace conversions; you need this for any video work)
34                         http://www.clanlib.org/hermes/
35 libghttp        (for httpsrc)
36                         http://ftp.gnome.org/pub/GNOME/stable/sources/libghttp/
37 libaudiofile    (for afsrc/afsink
38                         http://oss.sgi.com/projects/audiofile/
39 libmad          (for the mad mp3 decoder plugin)
40                         http://www.mars.org/home/rob/proj/mpeg/
41 libjpeg         (for jpegenc/jpegdec)
42                         http://www.ijg.org/
43 libopenquicktime (for the QT plugin)
44                         http://sourceforge.net/projects/openquicktime/
45 libXv           (for videosink)
46 libxaudio       (for xa mp3 decoder)
47                         http://www.xaudio.com/
48 libvorbis       (for vorbisenc, vorbisdec)
49                         http://www.xiph.org/ogg/vorbis/index.html
50 libcdparanoia   (for cdparanoia ripper)
51                         http://www.xiph.org/paranoia/index.html
52 liblame         (for lame mp3 encoder)
53                         http://www.mp3dev.org/mp3/
54 libshout        (for the shoutcast plugin)
55                         http://www.icecast.org
56 libasound       (for the alsa src/sink plugin)
57                         http://alsa-project.org/
58 librtp          (for the rtp sink plugin)
59                         http://www.linphone.org/ortp/
60 aalib           (for the aa sink plugin)
61                         http://aa-project.sourceforge.net/aalib/
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 plugin)
88                         http://swfdec.sourceforge.net
89                 >=      0.2.0
90 flac            (for the FLAC lossless audio format)
91                         http://flac.sourceforge.net
92                 >= 1.0.3 preferred, 1.0.2 should work
93 gtk             (for the gdk_pixbuf plugin)
94                         http://www.gtk.org/
95                 >= 2.2.1 preferred, 2.0 ok
96 pango           (for the textoverlay plugins)
97                         http://www.pango.org/
98
99 Optional debian packages:
100 =========================
101
102 gtk-doc-tools 0.4-0.2  -- needed to build documentation