docs/faq/getting.xml

   1 <sect1 id="chapter-getting">
   2   <title id="title-getting">Getting GStreamer</title>
   3   <qandaset defaultlabel="qanda">
   4
   5     <qandaentry>
   6       <question id="getting-gstreamer">
   7         <para>How do I get GStreamer ?</para>
   8       </question>
   9
  10       <answer>
  11         <para>
  12 Generally speaking, you have three options, ranging from easy to hard :
  13 <itemizedlist>
  14 <listitem><para><link linkend="getting-gstreamer-packages">
  15 distribution-specific packages</link></para></listitem>
  16 <listitem><para><link linkend="getting-gstreamer-source">
  17 source tarballs</link></para></listitem>
  18 <listitem><para><link linkend="getting-gstreamer-packages">
  19 git</link></para></listitem>
  20 </itemizedlist>
  21         </para>
  22       </answer>
  23     </qandaentry>
  24
  25    <qandaentry>
  26       <question id="gstreamer-versions-explained">
  27         <para>There seem to be different GStreamer versions, like 0.10 and 1.0?
  28               What's up with that?</para>
  29       </question>
  30
  31       <answer>
  32          <para>
  33            GStreamer-0.10 and GStreamer-1.0 are the main version
  34            &apos;series&apos; currently in use.  For all practical purposes
  35            you should think of them as two completely different libraries
  36            which just happen to have a similar name.  They can be installed
  37            in parallel and are completely independent.
  38          </para>
  39          <para>
  40            For the 0.10 version you will need the 0.10 plugins and bindings
  41            (gst-plugins 0.10.x, gst-ffmpeg 0.10.x, gst-python 0.10.x etc.), while
  42            for the 1.0 version you will need the 1.0 plugins and bindings
  43            (ie. gst-plugins-base 1.0.x, gst-plugins-good 1.0.x,
  44            gst-plugins-ugly 1.0.x, gst-plugins-bad 1.0.x, gst-ffmpeg 1.0.x,
  45            gst-python 1.0.x).  The micro version for each main version does
  46            not have to match exactly, only the major versions needs to be the
  47            same (ie. it may be that the current gst-plugins-good version is
  48            1.0.6 and the current GStreamer core version is 1.0.13).
  49            GStreamer-1.0 will not see or use any of the GStreamer-0.10 plugins
  50            and vice versa.
  51          </para>
  52          <para>
  53            All GStreamer command line tools are suffixed with their main
  54            version, e.g. gst-launch-0.10 and gst-launch-1.0, or gst-inspect-0.10
  55            and gst-inspect-1.0.
  56          </para>
  57          <para>
  58            Applications will use either GStreamer-0.10 or GStreamer-1.0, since
  59            the 0.10 and 1.0 API/ABI are not compatible.
  60          </para>
  61          <para>
  62            Odd-numbered versions such as 0.9.x, 0.11.x, etc. are unstable
  63            developer releases that should generally not be used.
  64          </para>
  65       </answer>
  66     </qandaentry>
  67
  68    <qandaentry>
  69       <question id="gstreamer-versions-which-one-to-get">
  70         <para>So which GStreamer version should I get?</para>
  71       </question>
  72
  73       <answer>
  74          <para>
  75            You should download GStreamer-1.0.  GStreamer-0.10 is end-of-life.
  76          </para>
  77       </answer>
  78     </qandaentry>
  79
  80     <qandaentry>
  81       <question id="getting-gstreamer-source">
  82         <para>How can I install GStreamer from source ?</para>
  83       </question>
  84
  85       <answer>
  86          <para>
  87 We provide tarballs of our releases on our
  88 <!-- <ulink url="http://sourceforge.net/project/showfiles.php?group_id=1936">
  89 Sourceforge files page.</ulink>
  90          </para>
  91          <para>
  92 We also put source tarballs on our -->own site, at
  93 <ulink url="http://gstreamer.freedesktop.org/src/">
  94 http://gstreamer.freedesktop.org/src/
  95 </ulink>
  96         </para>
  97         <para>
  98 When compiling from source, make sure you specify PKG_CONFIG_PATH correctly
  99 when building against GStreamer.  For example, if you configured GStreamer
 100 with the default prefix (which is /usr/local), then you need to
 101 <programlisting>
 102 export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
 103 </programlisting>
 104 before building gst-plugins.
 105         </para>
 106       </answer>
 107     </qandaentry>
 108
 109     <qandaentry>
 110       <question id="getting-gstreamer-packages">
 111         <para>Are there premade binaries available ?</para>
 112       </question>
 113
 114       <answer>
 115         <para>
 116         Yes we currently provide <ulink url="http://gstreamer.freedesktop.org/pkg/">precompiled packages for Windows, OS/X, Android and iOS</ulink>.
 117         </para>
 118         <para>
 119         We currently do not provide packages for Linux distributions, but
 120         rather rely on the distributions for that. GStreamer packages should
 121         be available for all major (and minor) distributions.
 122         </para>
 123      </answer>
 124     </qandaentry>
 125
 126  <qandaentry>
 127       <question id="getting-gstreamer3">
 128         <para>Why don't you provide premade binaries for distribution XY ?</para>
 129       </question>
 130
 131       <answer>
 132         <para>
 133         GStreamer is run on a volunteer basis. The package that are 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.
 134         </para>
 135       </answer>
 136     </qandaentry>
 137
 138 <qandaentry>
 139       <question id="getting-gstreamer4">
 140         <para>I am having trouble compiling GStreamer on my LFS installation, why ?</para>
 141       </question>
 142
 143       <answer>
 144         <para>
 145         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
 146 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.
 147         </para>
 148       </answer>
 149     </qandaentry>
 150
 151     <qandaentry>
 152       <question id="getting-gstreamer-git">
 153         <para>How do I get GStreamer through git ?</para>
 154       </question>
 155
 156       <answer>
 157         <para>
 158         see this page : <ulink url="http://gstreamer.freedesktop.org/dev/">http://gstreamer.freedesktop.org/dev/</ulink> for git access. (anonymous and developer)
 159         </para>
 160       </answer>
 161     </qandaentry>
 162
 163   </qandaset>
 164 </sect1>