wearable/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.8 and 0.10?
  28               What's up with that?</para>
  29       </question>
  30
  31       <answer>
  32          <para>
  33            GStreamer-0.8 and GStreamer-0.10 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.8 version you will need the 0.8 plugins and bindings
  41            (gst-plugins 0.8.x, gst-ffmpeg 0.8.x, gst-python 0.8.x etc.), while
  42            for the 0.10 version you will need the 0.10 plugins and bindings
  43            (ie. gst-plugins-base 0.10.x, gst-plugins-good 0.10.x,
  44            gst-plugins-ugly 0.10.x, gst-plugins-bad 0.10.x, gst-ffmpeg 0.10.x,
  45            gst-python 0.10.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            0.10.6 and the current GStreamer core version is 0.10.13).
  49            GStreamer-0.10 will not see or use any of the GStreamer-0.8 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.8 and gst-launch-0.10, or gst-inspect-0.8
  55            and gst-inspect-0.10.  The corresponding GStreamer command line
  56            tools without a suffix (e.g. gst-launch) will default to the highest
  57            major version.
  58          </para>
  59          <para>
  60            Applications will use either GStreamer-0.8 or GStreamer-0.10, since
  61            the 0.8 and 0.10 API/ABI are not compatible.
  62          </para>
  63          <para>
  64            Odd-numbered versions such as 0.9.x, 0.11.x, etc. are unstable
  65            developer releases that should generally not be used.
  66          </para>
  67       </answer>
  68     </qandaentry>
  69
  70    <qandaentry>
  71       <question id="gstreamer-versions-which-one-to-get">
  72         <para>So which GStreamer version should I get?</para>
  73       </question>
  74
  75       <answer>
  76          <para>
  77            You should download GStreamer-0.10.  GStreamer-0.8 is not developed
  78            any longer and has not been maintained for almost two years (you
  79            may still find it packaged for your disto though, but that's most
  80            likely for legacy applications).
  81          </para>
  82       </answer>
  83     </qandaentry>
  84
  85     <qandaentry>
  86       <question id="getting-gstreamer-source">
  87         <para>How can I install GStreamer from source ?</para>
  88       </question>
  89
  90       <answer>
  91          <para>
  92 We provide tarballs of our releases on our
  93 <!-- <ulink url="http://sourceforge.net/project/showfiles.php?group_id=1936">
  94 Sourceforge files page.</ulink>
  95          </para>
  96          <para>
  97 We also put source tarballs on our -->own site, at
  98 <ulink url="http://gstreamer.freedesktop.org/src/">
  99 http://gstreamer.freedesktop.org/src/
 100 </ulink>
 101         </para>
 102         <para>
 103 When compiling from source, make sure you specify PKG_CONFIG_PATH correctly
 104 when building against GStreamer.  For example, if you configured GStreamer
 105 with the default prefix (which is /usr/local), then you need to
 106 <programlisting>
 107 export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
 108 </programlisting>
 109 before building gst-plugins.
 110         </para>
 111       </answer>
 112     </qandaentry>
 113
 114     <qandaentry>
 115       <question id="getting-gstreamer-packages">
 116         <para>Are there premade binaries available ?</para>
 117       </question>
 118
 119       <answer>
 120         <para>
 121         Yes, we currently provide precompiled packages for Red Hat, Debian and Linux Mandrake. </para>
 122
 123 <para>We provide RPMS for Red Hat and Fedora Core through our <ulink url="http://gstreamer.freedesktop.org/pkg/">Apt for rpm page.</ulink> We usually support the last 2-3 releases of Red Hat. (RH9 and FC1)
 124         </para>
 125         <para>GStreamer is already in Debian experimental, so if you are a debian user you should be able to get the Debian packages from there.</para>
 126         <para>GStreamer is also in Mandrake Cooker so if you are using a recent release of Linux Mandrake you should be able to get GStreamer from there. To learn howto get packages from Mandrake cooker <ulink url="http://www.mandrakelinux.com/en/cookerdevel.php3">the Mandrake cooker page has more info</ulink>
 127         </para>
 128 <para>For other RPM based distributions we recommend getting the source tarball and doing 'rpm -ta gstreamer-0.X.X' to create rpms. We keep our SPEC file constantly up to date so you should always be able to build GStreamer rpms from a tarball. The SPEC file is aimed at Red Hat however, so there might be some need for you to edit the Requirements list if your distribution name these packages differently.</para>
 129       </answer>
 130     </qandaentry>
 131
 132  <qandaentry>
 133       <question id="getting-gstreamer3">
 134         <para>Why don't you provide premade binaries for distribution XY ?</para>
 135       </question>
 136
 137       <answer>
 138         <para>
 139         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.
 140         </para>
 141       </answer>
 142     </qandaentry>
 143
 144 <qandaentry>
 145       <question id="getting-gstreamer4">
 146         <para>I am having trouble compiling GStreamer on my LFS installation, why ?</para>
 147       </question>
 148
 149       <answer>
 150         <para>
 151         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
 152 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.
 153         </para>
 154       </answer>
 155     </qandaentry>
 156
 157     <qandaentry>
 158       <question id="getting-gstreamer-git">
 159         <para>How do I get GStreamer through git ?</para>
 160       </question>
 161
 162       <answer>
 163         <para>
 164         see this page : <ulink url="http://gstreamer.freedesktop.org/dev/">http://gstreamer.freedesktop.org/dev/</ulink> for git access. (anonymous and developer)
 165         </para>
 166       </answer>
 167     </qandaentry>
 168
 169   </qandaset>
 170 </sect1>