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:  libjpeg62-turbo-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