GStreamer uses a *large* array of tools and libraries, most of which are
-optional. We have attempted to make sure that any code that depends on
-optional libraries doesn't get built unless you have those libraries. If
+optional. We have attempted to make sure that any code that depends on
+optional libraries doesn't get built unless you have those libraries. If
you find this not to be the case, please, let us know by filing a bug
-report at http://sourceforge.net/bugs/?group_id=1936.
+report at http://bugzilla.gnome.org/.
+On Debian/Ubuntu, the easiest way to install most build requirements is:
-Required libraries:
-===================
-
-The core GStreamer libraries are required which depend on the following:
-
-the latest glib2, currently at v2.0.4
-libxml2 (also called gnome-xml, available from http://xmlsoft.org/)
-
-These libraries are all central parts of gnome, and are available from the
-ftp.gnome.org or its mirrors, amongst other places.
-
-
-Optional libraries:
-===================
-
-This file lists supporting libraries for which gst-plugins contains plugins,
-as well as their minimum version. You can find the corresponding plugins in
-ext/(library)
-
-gdk_pixbuf
-libgnomeui (for gstplay, gsteditor, autoplug example, several tests)
-libglade (for gstplay, gsteditor)
-libHermes (for colorspace conversions; you need this for any video work)
- http://www.clanlib.org/hermes/
-libghttp (for httpsrc)
- http://ftp.gnome.org/pub/GNOME/stable/sources/libghttp/
-libaudiofile (for afsrc/afsink)
- http://oss.sgi.com/projects/audiofile/
-libmad (for the mad mp3 decoder plugin)
- http://www.mars.org/home/rob/proj/mpeg/
-libjpeg (for jpegenc/jpegdec)
- http://www.ijg.org/
-libopenquicktime (for the QT plugin)
- http://sourceforge.net/projects/openquicktime/
-libXv (for videosink)
-libxaudio (for xa mp3 decoder)
- http://www.xaudio.com/
-libvorbis (for vorbisenc, vorbisdec)
- http://www.xiph.org/ogg/vorbis/index.html
-libcdparanoia (for cdparanoia ripper)
- http://www.xiph.org/paranoia/index.html
-liblame (for lame mp3 encoder)
- http://www.mp3dev.org/mp3/
-libshout (for the shoutcast plugin)
- http://www.icecast.org
-libasound (for the alsa src/sink plugin)
- http://alsa-project.org/
-ortp (for the rtp sink plugin)
- http://www.linphone.org/ortp/
-aalib (for the aa sink plugin)
- http://aa-project.sourceforge.net/aalib/
-aRts (for the arts plugin wrapper, and the artsd sink)
- http://www.arts-project.org
-raw1394/linux1394 (for the dv plugin)
- http://linux1394.sourceforge.net
-libdvdread (for the dvdsrc)
- http://www.dtek.chalmers.se/groups/dvd/
- (optional: libcss for encrypted DVDs)
-libesound (for the esd sink
- ftp.gnome.org/pub/GNOME/stable/sources/esound)
-gnome-vfs (for the gnome-vfs src)
-libgsm (for the gsm plugin)
- http://kbs.cs.tu-berlin.de/~jutta/toast.html
-sdl (for the sdl sink)
- http://www.libsdl.org
-xmms (for the xmms plugins wrapper)
- http://www.xmms.org
-mpeg2dec/a52dec (for mpeg2 related plugins and dvd playback)
- http://libmpeg2.sourceforge.net/
- and http://liba52.sourceforge.net/
- >= v0.2.1/v0.7.2
-avifile (for the avi windows decoder plugins)
- http://avifile.sourceforge.net/
- you might want to get the windows libraries
- from http://divx.euro.ru/ and put the .dll files
- in /usr/lib/win32/
- >= 0.6.0 (cvs)
-
-
-flac (for the FLAC lossless audio format)
- http://flac.sourceforge.net
-
+ sudo apt-get build-dep gst-plugins-good1.0
Required tools:
===============
-An extra set of tools is required if you wish to build GStreamer out of
-CVS (using autogen.sh):
-
-autoconf 2.52
-automake 1.5
-libtool v1.4 or better
-pkgconfig 0.8.0 (http://www.freedesktop.org/software/pkgconfig/)
-
-
-Optional tools:
-===============
-
-gtkdoc
-db2html
-fig2dev
-xsltproc
+An extra set of tools is required if you wish to build GStreamer
+from git (using autogen.sh):
+autoconf >= 2.68 https://www.gnu.org/software/autoconf/
+automake >= 1.11 https://www.gnu.org/software/automake/
+gettext >= 0.17 https://www.gnu.org/software/gettext/
+libtool >= 2.2.6 https://www.gnu.org/software/libtool/
+pkgconfig >= 0.9.0 https://www.freedesktop.org/software/pkgconfig/
-Optional debian packages:
-=========================
+Required libraries:
+===================
-(This is an incomplete list, made only of problems which have been reported,
-rather than by an audit.)
-task-helix-gnome-dev OR libgnome-dev
+Package: GStreamer
+Version: 1.x (same 1.x version as this package)
+Recommended: Latest 1.x
+URL: http://gstreamer.freedesktop.org/
+DebianPackage: libgstreamer1.0-dev
+Notes: The required version is updated frequently, so the version
+ listed in this file is often out of date. If you are compiling
+ from git master, you will usually need GStreamer core and
+ gst-plugins-base from git master as well.
+
+Package: GStreamer Base Plugins
+Version: 1.x (same 1.x version as this package)
+Recommended: Latest 1.x
+URL: http://gstreamer.freedesktop.org/
+DebianPackage: libgstreamer-plugins-base1.0-dev
+Notes: The required version is updated frequently, so the version
+ listed in this file is often out of date. If you are compiling
+ from git master, you will usually need GStreamer core and
+ gst-plugins-base from git master as well.
-gtk-doc-tools 0.4-0.2 -- needed to build documentation
-Alternatively, the docbook-gnome-bin package, which is available by adding the
-following lines to apt's sources.list (/etc/apt/sources.list):
+Optional libraries:
+===================
-deb ftp://ftp.home-of-linux.org/pub/debian gnome/
-deb-src ftp://ftp.home-of-linux.org/pub/debian gnome/
+This file lists supporting libraries for which gst-plugins-good contains
+plugins, as well as their minimum required version. You can find the
+corresponding plugins in ext/(library)
+
+Package: Orc
+Version: >= 0.4.17
+Recommended: Latest 0.4.x
+URL: http://gstreamer.freedesktop.org/data/src/orc/
+DebianPackage: liborc-0.4-dev
+Notes: Used by many plugins for accelerating SIMD processing using
+ run-time generated assembly. Not a hard requirement, but
+ highly recommended. Packagers, please hard-depend on liborc.
+ The git repository is http://cgit.freedesktop.org/gstreamer/orc/
+ (all versions on entropywave.com are outdated)
+
+Package: gdk-pixbuf Library
+Version: >= 2.8.0
+Recommended: Latest 2.x
+URL: http://www.gtk.org/
+DebianPackage: libgdk-pixbuf2.0-dev
+Plugins: gdkpixbuf (gdkpixbufdec, gdkpixbufoverlay)
+Notes: This library does not depend on Gtk+ or Gdk or any window system
+
+Package: GTK+
+Version: >= 3.0
+Recommended: Latest 3.x
+URL: http://www.gtk.org/
+DebianPackage: libgtk-3-dev
+Plugins: None
+Notes: Only needed by some of the examples, not by any plugins.
+
+Package: Xlib
+Plugins: ximagesrc
+DebianPackage: libx11-dev libxv-dev libxt-dev
+
+Package: AALib
+Plugins: aasink
+URL: http://aa-project.sourceforge.net/aalib/
+
+Package: Cairo
+Version: >= 1.10
+DebianPackage: libcairo2-dev
+Plugins: cairo (cairooverlay)
+URL: http://cairographics.org/
+
+Package: FLAC
+Version: >= 1.1.4
+DebianPackage: libflac-dev
+Plugins: flac (flacenc, flacdec)
+URL: http://flac.sourceforge.net/
+
+Package: gudev
+Version: >= 147
+DebianPackage: libgudev-1.0-dev
+Plugins: v4l2 (v4l2src)
+URL: http://www.freedesktop.org/software/systemd/
+Notes: This dependency is entirely optional, the video4linux plugin
+ will work just fine without it. gudev is only required for
+ the device probing and monitoring functionality to detect
+ video4linux devices appearing/disappearing at run-time.
+
+Package: JPEG library
+Plugins: jpeg (jpegenc, jpegdec, smokeenc, smokedec)
+DebianPackage: libjpeg-dev
+URL: http://www.libjpeg-turbo.org/
+ or http://www.ijg.org/ for the IJG version
+
+Package: Libcaca
+Plugins: cacasink
+DebianPackage: libcaca-dev
+URL: http://libcaca.zoy.org/
+
+Package: Libdv
+Version: >= 0.100
+DebianPackage: libdv4-dev
+Plugins: dv (dvdec)
+URL: http://libdv.sourceforge.net/
+
+Package: Libpng
+Version: >= 1.2
+DebianPackage: libpng12-dev
+Plugins: png (pngenc, pngdec)
+URL: http://www.libpng.org/pub/png/libpng.html
+
+Package: libraw1394
+Plugins: dv1394
+URL: http://www.linux1394.org/
+
+Package: libshout
+Version: >= 2.0
+DebianPackage: libshout3-dev
+plugins: shout2 (shout2send)
+URL: http://www.icecast.org/
+
+Package: speex
+Version: >= 1.1.6
+Plugins: speex (speexenc, speexdec)
+URL: http://www.speex.org/
+
+Package: taglib
+Version: >= 1.5
+DebianPackage: libtag1-dev
+Plugins: taglib (id3v2mux)
+URL: http://taglib.github.io/
+
+Package: zlib
+DebianPackage: zlib1g-dev
+Plugins: isomp4 (qtdemux), matroska (matroskademux)
+URL: http://www.zlib.net/
+
+Optional (debian) packages:
+===========================
+
+gtk-doc-tools >= 1.12 -- needed to build documentation
+python-xml -- needed to build plugin documentation