README

   1 WHAT IT IS
   2 ----------
   3 This is GStreamer, a framework for streaming media.  The
   4 fundamental design comes from the video pipeline at Oregon Graduate
   5 Institute, as well as some ideas from DirectMedia.  It's based on plug-ins
   6 that will provide the various codec and other functionality.  The
   7 interface hopefully is generic enough for various companies (ahem, Apple)
   8 to release binary codecs for Linux, until such time as they get a clue and
   9 release the source.
  10
  11
  12 COMPILING FROM SOURCE
  13 ---------------------
  14 - check output of ./configure --help to see if any options apply to you
  15 - run
  16   ./configure
  17   make
  18
  19   to build GStreamer.
  20 - if you want to install it (not required), run
  21   make install
  22 - You should create a registry for things to work.
  23   If you ran make install in the previous step, run
  24   gst-register
  25   as root.
  26
  27   If you didn't install, run
  28   tools/gst-register
  29   as a normal user.
  30
  31 - try out a simple test:
  32   gst-launch fakesrc num_buffers=5 ! fakesink
  33   (If you didn't install GStreamer, again prefix gst-launch with tools/)
  34
  35   If it outputs a bunch of messages from fakesrc and fakesink, everything is
  36   ok.
  37
  38 - After this, you're ready to install gst-plugins, which will provide the
  39   functionality you're probably looking for by now, so go on and read
  40   that README.
  41
  42 COMPILING FROM CVS
  43 ------------------
  44 When building from CVS sources, you will need to run autogen.sh to generate
  45 the build system files.
  46
  47 GStreamer is cutting-edge stuff.  To be a CVS developer, you need
  48 what used to be considered cutting-edge tools.
  49
  50 ATM, most of us have at least these versions :
  51
  52 * autoconf      2.52    (NOT 2.52d)
  53 * automake      1.5
  54 * libtool       1.4     (NOT Gentoo's genetic failure 1.4.2)
  55 * pkg-config    0.8.0
  56
  57 autogen.sh will check for these versions and complain if you don't have
  58 them.  You can also specify specific versions of automake and autoconf with
  59 --with-automake and --with-autoconf
  60
  61 Check autogen.sh options by running autogen.sh --help
  62
  63 autogen.sh can pass on arguments to configure - you just need to separate them
  64 from autogen.sh with -- between the two.
  65 prefix has been added to autogen.sh but will be passed on to configure because
  66 some build scripts like that.
  67
  68 When you have done this once, you can use autoregen.sh to re-autogen with
  69 the last passed options as a handy shortcut.  Use it.
  70
  71 After the autogen.sh stage, you can follow the directions listed in
  72 "COMPILING FROM SOURCE"
  73
  74