Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 1 | GStreamer uses a *large* array of tools and libraries, most of which are |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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 |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 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 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 7 | On Debian/Ubuntu, the easiest way to install most build requirements is: |
| 8 | |
| 9 | sudo apt-get build-dep gst-plugins-good1.0 |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 10 | |
| 11 | Required tools: |
| 12 | =============== |
| 13 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 14 | An extra set of tools is required if you wish to build GStreamer |
| 15 | from git (using autogen.sh): |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 16 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 22 | |
| 23 | Required libraries: |
| 24 | =================== |
| 25 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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. |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 35 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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. |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 45 | |
| 46 | |
| 47 | Optional libraries: |
| 48 | =================== |
| 49 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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) |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 53 | |
| 54 | Package: Orc |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 55 | Version: >= 0.4.17 |
| 56 | Recommended: Latest 0.4.x |
| 57 | URL: http://gstreamer.freedesktop.org/data/src/orc/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 58 | DebianPackage: liborc-0.4-dev |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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) |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 64 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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 |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 72 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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. |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 80 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 81 | Package: Xlib |
| 82 | Plugins: ximagesrc |
| 83 | DebianPackage: libx11-dev libxv-dev libxt-dev |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 84 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 85 | Package: AALib |
| 86 | Plugins: aasink |
| 87 | URL: http://aa-project.sourceforge.net/aalib/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 88 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 89 | Package: Cairo |
| 90 | Version: >= 1.10 |
| 91 | DebianPackage: libcairo2-dev |
| 92 | Plugins: cairo (cairooverlay) |
| 93 | URL: http://cairographics.org/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 94 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 95 | Package: FLAC |
| 96 | Version: >= 1.1.4 |
| 97 | DebianPackage: libflac-dev |
| 98 | Plugins: flac (flacenc, flacdec) |
| 99 | URL: http://flac.sourceforge.net/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 100 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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. |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 110 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 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 |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 116 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 117 | Package: Libcaca |
| 118 | Plugins: cacasink |
| 119 | DebianPackage: libcaca-dev |
| 120 | URL: http://libcaca.zoy.org/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 121 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 122 | Package: Libdv |
| 123 | Version: >= 0.100 |
| 124 | DebianPackage: libdv4-dev |
| 125 | Plugins: dv (dvdec) |
| 126 | URL: http://libdv.sourceforge.net/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 127 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 128 | Package: Libpng |
| 129 | Version: >= 1.2 |
| 130 | DebianPackage: libpng12-dev |
| 131 | Plugins: png (pngenc, pngdec) |
| 132 | URL: http://www.libpng.org/pub/png/libpng.html |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 133 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 134 | Package: libraw1394 |
| 135 | Plugins: dv1394 |
| 136 | URL: http://www.linux1394.org/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 137 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 138 | Package: libshout |
| 139 | Version: >= 2.0 |
| 140 | DebianPackage: libshout3-dev |
| 141 | plugins: shout2 (shout2send) |
| 142 | URL: http://www.icecast.org/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 143 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 144 | Package: speex |
| 145 | Version: >= 1.1.6 |
| 146 | Plugins: speex (speexenc, speexdec) |
| 147 | URL: http://www.speex.org/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 148 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 149 | Package: taglib |
| 150 | Version: >= 1.5 |
| 151 | DebianPackage: libtag1-dev |
| 152 | Plugins: taglib (id3v2mux) |
| 153 | URL: http://taglib.github.io/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 154 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 155 | Package: zlib |
| 156 | DebianPackage: zlib1g-dev |
| 157 | Plugins: isomp4 (qtdemux), matroska (matroskademux) |
| 158 | URL: http://www.zlib.net/ |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 159 | |
| 160 | Optional (debian) packages: |
| 161 | =========================== |
| 162 | |
Sebastian Dröge | 8704117 | 2015-03-17 09:12:48 +0100 | [diff] [blame] | 163 | gtk-doc-tools >= 1.12 -- needed to build documentation |
Olivier Naudan | 988c6f0 | 2012-04-16 07:16:25 -0400 | [diff] [blame] | 164 | python-xml -- needed to build plugin documentation |