README

   1 OggPlay: a library for playing Ogg multimedia
   2
   3 Overview
   4 --------
   5
   6 The current version of the plugin is still under development therefore
   7 the setup requires manual installation of the plugin. For more information,
   8 see also:
   9
  10   http://wiki.xiph.org/index.php/OggPlay
  11
  12 Dependencies
  13 ------------
  14
  15 For the core library (liboggplay), you need
  16
  17   * libogg, libvorbis, libtheora, optionally libspeex -- from http://www.xiph.org/
  18
  19     svn co http://svn.xiph.org/trunk/ogg/ ogg
  20     svn co http://svn.xiph.org/trunk/vorbis/ vorbis
  21     svn co http://svn.xiph.org/trunk/theora/ theora
  22
  23   * liboggz and libfishsound -- from svn.annodex.net:
  24
  25     git clone git://git.xiph.org/liboggz.git
  26     git clone git://git.xiph.org/libfishsound.git
  27
  28 Optionally, for Kate stream support, you need
  29
  30   * libkate -- from http://libkate.googlecode.com/
  31
  32 To render Kate streams as video overlays, you need
  33
  34   * libtiger -- from http://libtiger.googlecode.com/
  35
  36 Note that libtiger needs Pango and Cairo:
  37
  38   * Pango -- http://www.pango.org/
  39   * Cairo -- http://cairographics.com/
  40
  41 See the README files associated with these libraries for installation
  42 instructions.
  43
  44 To build src/examples/glut-player, you need:
  45   * The core liboggplay dependencies (listed above)
  46   * GLUT -- see http://www.opengl.org/resources/libraries/
  47
  48 To build src/examples/dump-all-streams, you need:
  49   * The core liboggplay dependencies (listed above)
  50   * libsndfile -- from http://www.mega-nerd.com/libsndfile/
  51
  52 To build src/tools/oggplay-dump-first-frame, you need:
  53   * The core liboggplay dependencies (listed above)
  54   * Imlib2 -- from your distribution or from
  55               http://sourceforge.net/project/showfiles.php?group_id=2&package_id=11130
  56
  57 On Debian, the required packages for all these additional libraries are:
  58   g++ libogg-dev libvorbis-dev libspeex-dev libtheora-dev libsndfile1-dev
  59   libimlib2-dev libglut-dev
  60
  61 Compile and Install liboggplay
  62 ------------------------------
  63
  64 ./autogen.sh
  65 ./configure
  66 make && make install
  67
  68