blob: 5f1b106314c4809a36b7d7c12d701d8c7781648b [file] [log] [blame]
Olivier Naudan988c6f02012-04-16 07:16:25 -04001GStreamer uses a *large* array of tools and libraries, most of which are
Sebastian Dröge87041172015-03-17 09:12:48 +01002optional. We have attempted to make sure that any code that depends on
3optional libraries doesn't get built unless you have those libraries. If
Olivier Naudan988c6f02012-04-16 07:16:25 -04004you find this not to be the case, please, let us know by filing a bug
5report at http://bugzilla.gnome.org/.
6
Sebastian Dröge87041172015-03-17 09:12:48 +01007On Debian/Ubuntu, the easiest way to install most build requirements is:
8
9 sudo apt-get build-dep gst-plugins-good1.0
Olivier Naudan988c6f02012-04-16 07:16:25 -040010
11Required tools:
12===============
13
Sebastian Dröge87041172015-03-17 09:12:48 +010014An extra set of tools is required if you wish to build GStreamer
15from git (using autogen.sh):
Olivier Naudan988c6f02012-04-16 07:16:25 -040016
Sebastian Dröge87041172015-03-17 09:12:48 +010017autoconf >= 2.68 https://www.gnu.org/software/autoconf/
18automake >= 1.11 https://www.gnu.org/software/automake/
19gettext >= 0.17 https://www.gnu.org/software/gettext/
20libtool >= 2.2.6 https://www.gnu.org/software/libtool/
21pkgconfig >= 0.9.0 https://www.freedesktop.org/software/pkgconfig/
Olivier Naudan988c6f02012-04-16 07:16:25 -040022
23Required libraries:
24===================
25
Sebastian Dröge87041172015-03-17 09:12:48 +010026Package: GStreamer
27Version: 1.x (same 1.x version as this package)
28Recommended: Latest 1.x
29URL: http://gstreamer.freedesktop.org/
30DebianPackage: libgstreamer1.0-dev
31Notes: 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.
Olivier Naudan988c6f02012-04-16 07:16:25 -040035
Sebastian Dröge87041172015-03-17 09:12:48 +010036Package: GStreamer Base Plugins
37Version: 1.x (same 1.x version as this package)
38Recommended: Latest 1.x
39URL: http://gstreamer.freedesktop.org/
40DebianPackage: libgstreamer-plugins-base1.0-dev
41Notes: 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.
Olivier Naudan988c6f02012-04-16 07:16:25 -040045
46
47Optional libraries:
48===================
49
Sebastian Dröge87041172015-03-17 09:12:48 +010050This file lists supporting libraries for which gst-plugins-good contains
51plugins, as well as their minimum required version. You can find the
52corresponding plugins in ext/(library)
Olivier Naudan988c6f02012-04-16 07:16:25 -040053
54Package: Orc
Sebastian Dröge87041172015-03-17 09:12:48 +010055Version: >= 0.4.17
56Recommended: Latest 0.4.x
57URL: http://gstreamer.freedesktop.org/data/src/orc/
Olivier Naudan988c6f02012-04-16 07:16:25 -040058DebianPackage: liborc-0.4-dev
Sebastian Dröge87041172015-03-17 09:12:48 +010059Notes: 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)
Olivier Naudan988c6f02012-04-16 07:16:25 -040064
Sebastian Dröge87041172015-03-17 09:12:48 +010065Package: gdk-pixbuf Library
66Version: >= 2.8.0
67Recommended: Latest 2.x
68URL: http://www.gtk.org/
69DebianPackage: libgdk-pixbuf2.0-dev
70Plugins: gdkpixbuf (gdkpixbufdec, gdkpixbufoverlay)
71Notes: This library does not depend on Gtk+ or Gdk or any window system
Olivier Naudan988c6f02012-04-16 07:16:25 -040072
Sebastian Dröge87041172015-03-17 09:12:48 +010073Package: GTK+
74Version: >= 3.0
75Recommended: Latest 3.x
76URL: http://www.gtk.org/
77DebianPackage: libgtk-3-dev
78Plugins: None
79Notes: Only needed by some of the examples, not by any plugins.
Olivier Naudan988c6f02012-04-16 07:16:25 -040080
Sebastian Dröge87041172015-03-17 09:12:48 +010081Package: Xlib
82Plugins: ximagesrc
83DebianPackage: libx11-dev libxv-dev libxt-dev
Olivier Naudan988c6f02012-04-16 07:16:25 -040084
Sebastian Dröge87041172015-03-17 09:12:48 +010085Package: AALib
86Plugins: aasink
87URL: http://aa-project.sourceforge.net/aalib/
Olivier Naudan988c6f02012-04-16 07:16:25 -040088
Sebastian Dröge87041172015-03-17 09:12:48 +010089Package: Cairo
90Version: >= 1.10
91DebianPackage: libcairo2-dev
92Plugins: cairo (cairooverlay)
93URL: http://cairographics.org/
Olivier Naudan988c6f02012-04-16 07:16:25 -040094
Sebastian Dröge87041172015-03-17 09:12:48 +010095Package: FLAC
96Version: >= 1.1.4
97DebianPackage: libflac-dev
98Plugins: flac (flacenc, flacdec)
99URL: http://flac.sourceforge.net/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400100
Sebastian Dröge87041172015-03-17 09:12:48 +0100101Package: gudev
102Version: >= 147
103DebianPackage: libgudev-1.0-dev
104Plugins: v4l2 (v4l2src)
105URL: http://www.freedesktop.org/software/systemd/
106Notes: 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.
Olivier Naudan988c6f02012-04-16 07:16:25 -0400110
Sebastian Dröge87041172015-03-17 09:12:48 +0100111Package: JPEG library
112Plugins: jpeg (jpegenc, jpegdec, smokeenc, smokedec)
113DebianPackage: libjpeg-dev
114URL: http://www.libjpeg-turbo.org/
115 or http://www.ijg.org/ for the IJG version
Olivier Naudan988c6f02012-04-16 07:16:25 -0400116
Sebastian Dröge87041172015-03-17 09:12:48 +0100117Package: Libcaca
118Plugins: cacasink
119DebianPackage: libcaca-dev
120URL: http://libcaca.zoy.org/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400121
Sebastian Dröge87041172015-03-17 09:12:48 +0100122Package: Libdv
123Version: >= 0.100
124DebianPackage: libdv4-dev
125Plugins: dv (dvdec)
126URL: http://libdv.sourceforge.net/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400127
Sebastian Dröge87041172015-03-17 09:12:48 +0100128Package: Libpng
129Version: >= 1.2
130DebianPackage: libpng12-dev
131Plugins: png (pngenc, pngdec)
132URL: http://www.libpng.org/pub/png/libpng.html
Olivier Naudan988c6f02012-04-16 07:16:25 -0400133
Sebastian Dröge87041172015-03-17 09:12:48 +0100134Package: libraw1394
135Plugins: dv1394
136URL: http://www.linux1394.org/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400137
Sebastian Dröge87041172015-03-17 09:12:48 +0100138Package: libshout
139Version: >= 2.0
140DebianPackage: libshout3-dev
141plugins: shout2 (shout2send)
142URL: http://www.icecast.org/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400143
Sebastian Dröge87041172015-03-17 09:12:48 +0100144Package: speex
145Version: >= 1.1.6
146Plugins: speex (speexenc, speexdec)
147URL: http://www.speex.org/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400148
Sebastian Dröge87041172015-03-17 09:12:48 +0100149Package: taglib
150Version: >= 1.5
151DebianPackage: libtag1-dev
152Plugins: taglib (id3v2mux)
153URL: http://taglib.github.io/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400154
Sebastian Dröge87041172015-03-17 09:12:48 +0100155Package: zlib
156DebianPackage: zlib1g-dev
157Plugins: isomp4 (qtdemux), matroska (matroskademux)
158URL: http://www.zlib.net/
Olivier Naudan988c6f02012-04-16 07:16:25 -0400159
160Optional (debian) packages:
161===========================
162
Sebastian Dröge87041172015-03-17 09:12:48 +0100163gtk-doc-tools >= 1.12 -- needed to build documentation
Olivier Naudan988c6f02012-04-16 07:16:25 -0400164python-xml -- needed to build plugin documentation