2016-11-10 12:02:55 +00:00
|
|
|
# Getting GStreamer
|
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## How do I get GStreamer?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
Generally speaking, you have three options, ranging from easy to hard :
|
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
- [binary packages for Windows, macOS, iOS and Android](#getting-binary-sdk)
|
|
|
|
|
2016-11-10 12:02:55 +00:00
|
|
|
- [distribution-specific packages](#getting-gstreamer-packages)
|
|
|
|
|
|
|
|
- [source tarballs](#getting-gstreamer-source)
|
|
|
|
|
|
|
|
- [git](#getting-gstreamer-packages)
|
|
|
|
|
2017-05-31 18:19:06 +00:00
|
|
|
## What is the difference between versions 0.10 and 1.0?
|
|
|
|
|
|
|
|
*There seem to be different GStreamer versions, like 0.10 and 1.0? What's up with that?*
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
GStreamer-0.10 and GStreamer-1.0 are the main version 'series'
|
|
|
|
currently in use. For all practical purposes you should think of them as
|
|
|
|
two completely different libraries which just happen to have a similar
|
|
|
|
name. They can be installed in parallel and are completely independent.
|
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
GStreamer 1.x has been the main stable series since 2012. GStreamer 0.10 is
|
|
|
|
no longer maintained.
|
|
|
|
|
2016-11-10 12:02:55 +00:00
|
|
|
For the 0.10 version you will need the 0.10 plugins and bindings
|
|
|
|
(gst-plugins 0.10.x, gst-ffmpeg 0.10.x, gst-python 0.10.x etc.), while
|
|
|
|
for the 1.0 version you will need the 1.0 plugins and bindings (ie.
|
|
|
|
gst-plugins-base 1.0.x, gst-plugins-good 1.0.x, gst-plugins-ugly 1.0.x,
|
|
|
|
gst-plugins-bad 1.0.x, gst-ffmpeg 1.0.x, gst-python 1.0.x). The micro
|
|
|
|
version for each main version does not have to match exactly, only the
|
|
|
|
major versions needs to be the same (ie. it may be that the current
|
|
|
|
gst-plugins-good version is 1.0.6 and the current GStreamer core version
|
|
|
|
is 1.0.13). GStreamer-1.0 will not see or use any of the GStreamer-0.10
|
|
|
|
plugins and vice versa.
|
|
|
|
|
|
|
|
All GStreamer command line tools are suffixed with their main version,
|
2016-11-15 10:53:38 +00:00
|
|
|
e.g. `gst-launch-1.0` and `gst-inspect-1.0`.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
Applications will use either GStreamer-1.0 or GStreamer-0.10, since the
|
|
|
|
1.0 and 0.10 API/ABI are not compatible.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
Odd-numbered versions such as 0.9.x, 0.11.x, 1.3.x, 1.5.x, 1.7.x etc. are
|
|
|
|
unstable developer releases that should generally not be used.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-31 18:19:06 +00:00
|
|
|
### So which GStreamer version should I get?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
You should download GStreamer 1.x. GStreamer-0.10 is no longer maintained.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## How can I install GStreamer from source?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
We provide tarballs of our releases on our own site, at
|
|
|
|
<http://gstreamer.freedesktop.org/src/>
|
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
When compiling from source, make sure you set the `PKG_CONFIG_PATH`
|
|
|
|
environment variable correctly to the pkgconfig subdir of your install
|
|
|
|
prefix's libdir, to make sure your newly-installed GStreamer versions are
|
|
|
|
picked up when building against GStreamer. For example, if you
|
|
|
|
configured GStreamer with the default prefix (which is `/usr/local`), then
|
2017-05-31 18:19:06 +00:00
|
|
|
you need to:
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-31 18:19:06 +00:00
|
|
|
```
|
|
|
|
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
|
|
|
|
```
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
before building GStreamer plugin modules. After installing GStreamer from
|
|
|
|
source on Linux, run `sudo ldconfig` to make sure your new libs will be found.
|
|
|
|
|
|
|
|
Please note that GStreamer is not an easy thing to build from source, since it
|
|
|
|
has so many interconnected pieces from multiple modules, which must all be
|
|
|
|
installed just right and must all find each other in the right versions.
|
|
|
|
|
|
|
|
If you have GStreamer already installed from packages, it is strongly
|
|
|
|
recommended that you find newer packages instead of installing from source, or
|
|
|
|
upgrade to a distro version that ships newer packages. Installing from source
|
|
|
|
into one prefix with distro packages in another prefix can cause problems if
|
|
|
|
it's not done right, and it is very difficult for anyone to provide help with
|
|
|
|
such a setup.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## Are there premade binaries available?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-15 10:53:38 +00:00
|
|
|
Yes, we currently provide [precompiled packages for Windows, OS/X,
|
2016-11-10 12:02:55 +00:00
|
|
|
Android and iOS](http://gstreamer.freedesktop.org/pkg/).
|
|
|
|
|
|
|
|
We currently do not provide packages for Linux distributions, but rather
|
|
|
|
rely on the distributions for that. GStreamer packages should be
|
|
|
|
available for all major (and minor) distributions.
|
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## Why don't you provide premade binaries for distribution XY?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-31 18:19:06 +00:00
|
|
|
GStreamer is run on a volunteer basis. The packages that are
|
2016-11-10 12:02:55 +00:00
|
|
|
provided are made by non-paid people who do this on their own time. The
|
|
|
|
distributions we support with binaries are the distributions that we
|
|
|
|
have people who have volunteered to make binaries for. If you are
|
|
|
|
interested in maintaining GStreamer binaries for other distributions or
|
|
|
|
Unices we would be happy to hear from you. Contact us through the
|
|
|
|
GStreamer-devel mailing list.
|
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## I am having trouble compiling GStreamer on my LFS installation, why?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
If you are running LFS our basic opinion is that you should be
|
|
|
|
knowledgeable enough to solve any build issues you get on your own.
|
|
|
|
Being volunteered based we can't promise support to anyone of course,
|
|
|
|
but are you using LFS consider yourself extra unsupported. We neither
|
|
|
|
can or want to know enough, about how your unique system is configured,
|
|
|
|
to be able to help you. That said, if you come to the \#gstreamer
|
|
|
|
channel on irc.openprojects.net we might of course be able to give you
|
|
|
|
some general hints and pointers.
|
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## How do I get GStreamer through git?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
See this page : <http://gstreamer.freedesktop.org/dev/> for git
|
|
|
|
access (anonymous and developer).
|