Move qt plugin from -bad
[platform/upstream/gst-plugins-good.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:        liblame
129 Version:        >= 3.98
130 DebianPackage:  libmp3lame-dev
131 Plugins:        lame (lamemp3enc)
132 URL:            http://www.mp3dev.org/mp3/
133
134 Package:        libmpg123
135 Version:        >= 1.3
136 DebianPackage:  libpng12-dev
137 Plugins:        mpg123 (mpg123audiodec)
138 URL:            https://www.mpg123.de/api/
139
140 Package:        Libpng
141 Version:        >= 1.2
142 DebianPackage:  libpng12-dev
143 Plugins:        png (pngenc, pngdec)
144 URL:            http://www.libpng.org/pub/png/libpng.html
145
146 Package:        libraw1394
147 Plugins:        dv1394
148 URL:            http://www.linux1394.org/
149
150 Package:        libshout
151 Version:        >= 2.0
152 DebianPackage:  libshout3-dev
153 plugins:        shout2 (shout2send)
154 URL:            http://www.icecast.org/
155
156 Package:        speex
157 Version:        >= 1.1.6
158 Plugins:        speex (speexenc, speexdec)
159 URL:            http://www.speex.org/
160
161 Package:        taglib
162 Version:        >= 1.5
163 DebianPackage:  libtag1-dev
164 Plugins:        taglib (id3v2mux)
165 URL:            http://taglib.github.io/
166
167 Package:        twolame
168 Version:        >= 0.3.13
169 DebianPackage:  libtwolame-dev
170 Plugins:        twolame (twolamemp2enc)
171 URL:            http://www.twolame.org
172
173 Package:        zlib
174 DebianPackage:  zlib1g-dev
175 Plugins:        isomp4 (qtdemux), matroska (matroskademux)
176 URL:            http://www.zlib.net/
177
178 Optional (debian) packages:
179 ===========================
180
181 gtk-doc-tools >= 1.12  -- needed to build documentation
182 python-xml  -- needed to build plugin documentation