mpg123: hook up to build system
[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 On Debian/Ubuntu, the easiest way to install most build requirements is:
8
9         sudo apt-get build-dep gst-plugins-good1.0
10
11 Required tools:
12 ===============
13
14 An extra set of tools is required if you wish to build GStreamer
15 from git (using autogen.sh):
16
17 autoconf  >= 2.68   https://www.gnu.org/software/autoconf/
18 automake  >= 1.11   https://www.gnu.org/software/automake/
19 gettext   >= 0.17   https://www.gnu.org/software/gettext/
20 libtool   >= 2.2.6  https://www.gnu.org/software/libtool/
21 pkgconfig >= 0.9.0  https://www.freedesktop.org/software/pkgconfig/
22
23 Required libraries:
24 ===================
25
26 Package:        GStreamer
27 Version:        1.x (same 1.x version as this package)
28 Recommended:    Latest 1.x
29 URL:            http://gstreamer.freedesktop.org/
30 DebianPackage:  libgstreamer1.0-dev
31 Notes:          The required version is updated frequently, so the version
32                 listed in this file is often out of date. If you are compiling
33                 from git master, you will usually need GStreamer core and
34                 gst-plugins-base from git master as well.
35
36 Package:        GStreamer Base Plugins
37 Version:        1.x (same 1.x version as this package)
38 Recommended:    Latest 1.x
39 URL:            http://gstreamer.freedesktop.org/
40 DebianPackage:  libgstreamer-plugins-base1.0-dev
41 Notes:          The required version is updated frequently, so the version
42                 listed in this file is often out of date. If you are compiling
43                 from git master, you will usually need GStreamer core and
44                 gst-plugins-base from git master as well.
45
46
47 Optional libraries:
48 ===================
49
50 This file lists supporting libraries for which gst-plugins-good contains
51 plugins, as well as their minimum required version. You can find the
52 corresponding plugins in ext/(library)
53
54 Package:        Orc
55 Version:        >= 0.4.17
56 Recommended:    Latest 0.4.x
57 URL:            http://gstreamer.freedesktop.org/data/src/orc/
58 DebianPackage:  liborc-0.4-dev
59 Notes:          Used by many plugins for accelerating SIMD processing using
60                 run-time generated assembly. Not a hard requirement, but
61                 highly recommended. Packagers, please hard-depend on liborc.
62                 The git repository is http://cgit.freedesktop.org/gstreamer/orc/
63                 (all versions on entropywave.com are outdated)
64
65 Package:        gdk-pixbuf Library
66 Version:        >= 2.8.0
67 Recommended:    Latest 2.x
68 URL:            http://www.gtk.org/
69 DebianPackage:  libgdk-pixbuf2.0-dev
70 Plugins:        gdkpixbuf (gdkpixbufdec, gdkpixbufoverlay)
71 Notes:          This library does not depend on Gtk+ or Gdk or any window system
72
73 Package:        GTK+
74 Version:        >= 3.0
75 Recommended:    Latest 3.x
76 URL:            http://www.gtk.org/
77 DebianPackage:  libgtk-3-dev
78 Plugins:        None
79 Notes:          Only needed by some of the examples, not by any plugins.
80
81 Package:        Xlib
82 Plugins:        ximagesrc
83 DebianPackage:  libx11-dev libxv-dev libxt-dev
84
85 Package:        AALib
86 Plugins:        aasink
87 URL:            http://aa-project.sourceforge.net/aalib/
88
89 Package:        Cairo
90 Version:        >= 1.10
91 DebianPackage:  libcairo2-dev
92 Plugins:        cairo (cairooverlay)
93 URL:            http://cairographics.org/
94
95 Package:        FLAC
96 Version:        >= 1.1.4
97 DebianPackage:  libflac-dev
98 Plugins:        flac (flacenc, flacdec)
99 URL:            http://flac.sourceforge.net/
100
101 Package:        gudev
102 Version:        >= 147
103 DebianPackage:  libgudev-1.0-dev
104 Plugins:        v4l2 (v4l2src)
105 URL:            http://www.freedesktop.org/software/systemd/
106 Notes:          This dependency is entirely optional, the video4linux plugin
107                 will work just fine without it. gudev is only required for
108                 the device probing and monitoring functionality to detect
109                 video4linux devices appearing/disappearing at run-time.
110
111 Package:        JPEG library
112 Plugins:        jpeg (jpegenc, jpegdec, smokeenc, smokedec)
113 DebianPackage:  libjpeg-dev
114 URL:            http://www.libjpeg-turbo.org/
115                 or http://www.ijg.org/ for the IJG version
116
117 Package:        Libcaca
118 Plugins:        cacasink
119 DebianPackage:  libcaca-dev
120 URL:            http://libcaca.zoy.org/
121
122 Package:        Libdv
123 Version:        >= 0.100
124 DebianPackage:  libdv4-dev
125 Plugins:        dv (dvdec)
126 URL:            http://libdv.sourceforge.net/
127
128 Package:        libmpg123
129 Version:        >= 1.3
130 DebianPackage:  libpng12-dev
131 Plugins:        mpg123 (mpg123audiodec)
132 URL:            https://www.mpg123.de/api/
133
134 Package:        Libpng
135 Version:        >= 1.2
136 DebianPackage:  libpng12-dev
137 Plugins:        png (pngenc, pngdec)
138 URL:            http://www.libpng.org/pub/png/libpng.html
139
140 Package:        libraw1394
141 Plugins:        dv1394
142 URL:            http://www.linux1394.org/
143
144 Package:        libshout
145 Version:        >= 2.0
146 DebianPackage:  libshout3-dev
147 plugins:        shout2 (shout2send)
148 URL:            http://www.icecast.org/
149
150 Package:        speex
151 Version:        >= 1.1.6
152 Plugins:        speex (speexenc, speexdec)
153 URL:            http://www.speex.org/
154
155 Package:        taglib
156 Version:        >= 1.5
157 DebianPackage:  libtag1-dev
158 Plugins:        taglib (id3v2mux)
159 URL:            http://taglib.github.io/
160
161 Package:        zlib
162 DebianPackage:  zlib1g-dev
163 Plugins:        isomp4 (qtdemux), matroska (matroskademux)
164 URL:            http://www.zlib.net/
165
166 Optional (debian) packages:
167 ===========================
168
169 gtk-doc-tools >= 1.12  -- needed to build documentation
170 python-xml  -- needed to build plugin documentation