- Cleanups
[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 libtool v1.4 or better
17 pkgconfig 0.9.0 or better (http://www.freedesktop.org/software/pkgconfig/)
18
19 Required libraries:
20 ===================
21
22 The core GStreamer libraries. See the gstreamer/ module in GStreamer cvs, or
23 the version that corresponds to this plugin release.
24
25 Optional libraries:
26 ===================
27
28 This file lists supporting libraries for which gst-plugins contains plugins,
29 as well as their minimum version.  You can find the corresponding plugins in
30 ext/(library)
31
32 libHermes       (for colorspace conversions; you need this for any video work)
33                         http://www.clanlib.org/hermes/
34 libghttp        (for httpsrc)
35                         http://ftp.gnome.org/pub/GNOME/stable/sources/libghttp/
36 libaudiofile    (for afsrc/afsink
37                         http://oss.sgi.com/projects/audiofile/
38 libmad          (for the mad mp3 decoder plugin)
39                         http://www.mars.org/home/rob/proj/mpeg/
40 libjpeg         (for jpegenc/jpegdec)
41                         http://www.ijg.org/
42 libopenquicktime (for the QT plugin)
43                         http://sourceforge.net/projects/openquicktime/
44 libXv           (for videosink)
45 libxaudio       (for xa mp3 decoder)
46                         http://www.xaudio.com/
47 libvorbis       (for vorbisenc, vorbisdec)
48                         http://www.xiph.org/ogg/vorbis/index.html
49 libcdparanoia   (for cdparanoia ripper)
50                         http://www.xiph.org/paranoia/index.html
51 liblame         (for lame mp3 encoder)
52                         http://www.mp3dev.org/mp3/
53 libshout        (for the shoutcast plugin)
54                         http://www.icecast.org
55 libasound       (for the alsa src/sink plugin)
56                         http://alsa-project.org/
57 librtp          (for the rtp sink plugin)
58                         http://www.linphone.org/ortp/
59 aalib           (for the aa sink plugin)
60                         http://aa-project.sourceforge.net/aalib/
61 aRts            (for the arts plugin wrapper, and the artsd sink)
62                         http://www.arts-project.org
63 raw1394/linux1394       (for the dv plugin)
64                         http://linux1394.sourceforge.net
65 libdvdread      (for the dvdsrc)
66                         http://www.dtek.chalmers.se/groups/dvd/
67                         (optional: libcss for encrypted DVDs)
68 libesound       (for the esd sink 
69                         ftp.gnome.org/pub/GNOME/stable/sources/esound)
70 gnome-vfs       (for the gnome-vfs src)
71 libgsm          (for the gsm plugin)
72                         http://kbs.cs.tu-berlin.de/~jutta/toast.html
73 sdl             (for the sdl sink)
74                         http://www.libsdl.org
75 xmms            (for the xmms plugins wrapper)
76                         http://www.xmms.org
77 mpeg2dec/a52dec (for mpeg2 related plugins and dvd playback)
78                         http://libmpeg2.sourceforge.net/
79                         and http://liba52.sourceforge.net/
80                 >=      v0.3.1/v0.7.2
81 swfdec          (for the swfdec plugin)
82                         http://swfdec.sourceforge.net
83                 >=      0.2.0
84
85 flac            (for the FLAC lossless audio format)
86                         http://flac.sourceforge.net
87                 >= 1.0.3 preferred, 1.0.2 should work
88
89 Optional debian packages:
90 =========================
91
92 gtk-doc-tools 0.4-0.2  -- needed to build documentation