- Added FLAC information
[platform/upstream/gstreamer.git] / REQUIREMENTS
1 GStreamer use 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://sourceforge.net/bugs/?group_id=1936.
6
7
8 Required libraries:
9 ===================
10 glib v1.2.0 or better
11 gtk+ v1.2.0 or better
12 libxml          (also called gnome-xml, available from http://xmlsoft.org/)
13 libHermes       (for gstplay)
14                         http://www.clanlib.org/hermes/
15
16 These libraries are all central parts of gnome, and are available from the
17 ftp.gnome.org or its mirrors, amongst other places.
18
19 Optional libraries:
20 ===================
21 gdk_pixbuf
22 libgnomeui      (for gstplay, gsteditor, autoplug example, several tests)
23 libglade        (for gstplay, gsteditor)
24
25 libghttp        (for httpsrc)
26                         http://ftp.gnome.org/pub/GNOME/stable/sources/libghttp/
27 libaudiofile    (for afsrc/afsink)
28                         http://oss.sgi.com/projects/audiofile/
29 libmad          (for the mad mp3 decoder plugin)
30                         http://www.mars.org/home/rob/proj/mpeg/
31 libjpeg         (for jpegenc/jpegdec)
32                         http://www.ijg.org/
33 libopenquicktime (for the QT plugin)
34                         http://sourceforge.net/projects/openquicktime/
35 libXv           (for videosink)
36 libxaudio       (for xa mp3 decoder)
37                         http://www.xaudio.com/
38 libvorbis       (for vorbisenc, vorbisdec)
39                         http://www.xiph.org/ogg/vorbis/index.html
40 libcdparanoia   (for cdparanoia ripper)
41                         http://www.xiph.org/paranoia/index.html
42 liblame         (for lame mp3 encoder)
43                         http://www.mp3dev.org/mp3/
44 libshout        (for the shoutcast plugin)
45                         http://www.icecast.org
46 libasound       (for the alsa src/sink plugin)
47                         http://alsa-project.org/
48 librtp          (for the rtp sink plugin, shipped with Gnome-O-Phone)
49                         http://sourceforge.net/projects/gphone
50 aalib           (for the aa sink plugin)
51                         http://aa-project.sourceforge.net/aalib/
52 aRts            (for the arts plugin wrapper, and the artsd sink)
53                         http://www.arts-project.org
54 raw1394/linux1394       (for the dv plugin)
55                         http://linux1394.sourceforge.net
56 decss           (for the dvdsrc)
57                         http://www.linuxrising.com/dvd-munitions_tar.gz
58 libesound       (for the esd sink 
59                         ftp.gnome.org/pub/GNOME/stable/sources/esound)
60 gnome-vfs       (for the gnome-vfs src)
61 libgsm          (for the gsm plugin)
62                         http://kbs.cs.tu-berlin.de/~jutta/toast.html
63 sdl             (for the sdl sink)
64                         http://www.libsdl.org
65 xmms            (for the xmms plugins wrapper)
66                         http://www.xmms.org
67 mpeg2dec/ac3dec (for mpeg2 related plugins and dvd playback)
68                         http://linuxvideo.org/mpeg2dec/
69                         and http://linuxvideo.org/ac3dec/
70 avifile         (for the avi windows decoder plugins
71                         you might want to get the windows libraries 
72                         from http://divx.euro.ru/ and put the .dll files 
73                         in /usr/lib/win32/)
74 flac            (for the FLAC lossless audio format)
75                         http://flac.sourceforge.net
76
77 An extra set of tools is required if you wish to build GStreamer out of
78 CVS (using autogen.sh):
79
80 Required tools:
81 ===============
82 autoconf
83 automake v1.4 or better
84 libtool v1.3.5 or better
85
86 Optional tools:
87 ===============
88 gtkdoc
89 db2html
90 fig2dev
91
92 Optional debian packages:
93 =========================
94 (This is an incomplete list, made only of problems which have been reported,
95 rather than by an audit.)
96 task-helix-gnome-dev   OR libgnome-dev
97
98 gtk-doc-tools 0.4-0.2  -- needed to build documentation