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