vorbis-tools/README

   1 WHAT'S HERE:
   2
   3 This source distribution includes the vorbis-tools and nothing else.
   4 The audio codec libraries for use with Ogg bitstreams are contained in
   5 other modules: vorbis, speex and flac.
   6
   7 DIRECTORIES:
   8
   9 debian/         debian packaging stuff
  10 include/        header files shared between the tools
  11 intl/           GNU gettext library from gettext-0.10.40 (for i18n support)
  12 ogg123/         an ogg vorbis command line audio player
  13 oggenc/         the ogg vorbis encoder
  14 oggdec/         a simple, portable command line decoder (to wav and raw)
  15 ogginfo/        provides information (tags, bitrate, length, etc.) about
  16                 an ogg vorbis file
  17 po/             translations for non-English languages
  18 share/          code shared between the tools
  19 vcut/           cuts an ogg vorbis file into two parts at a particular point
  20 vorbiscomment/  edits the comments in an ogg vorbis file
  21 win32/          Win32 build stuff
  22
  23 DEPENDENCIES:
  24
  25 All of the tools require libogg and libvorbis to be installed (along
  26 with the header files).  Additionally, ogg123 requires libao, libcurl,
  27 and a POSIX-compatible thread library.  Ogg123 can optionally compiled
  28 to use libFLAC, libOggFLAC, and libspeex.  Oggenc can be optionally
  29 compiled with libFLAC and libOggFLAC.  The libraries libogg,
  30 libvorbis, and libao are all available at
  31   http://www.vorbis.com/download.psp
  32
  33 The libcurl library is packaged with most Linux distributions.  The
  34 source code can also be downloaded from:
  35   http://curl.haxx.se/libcurl/
  36
  37 FLAC is available at:
  38   http://flac.sourceforge.net
  39
  40 Speex is available at:
  41   http://www.speex.org/
  42
  43 CONTACT:
  44
  45 The Ogg Vorbis homepage is located at 'http://www.vorbis.com'. Up to
  46 date technical documents, contact information, source code and
  47 pre-built utilities may be found there.
  48
  49 Developer information is available from http://www.xiph.org/. Check
  50 there for bug reporting information, mailing lists and other resources.
  51
  52 BUILDING FROM SUBVERSION (see the file HACKING for details):
  53
  54 ./autogen.sh
  55 make
  56
  57 and as root if desired :
  58
  59 make install
  60
  61 This will install the tools into /usr/local/bin and manpages into
  62 /usr/local/man.
  63
  64 BUILDING FROM TARBALL DISTRIBUTIONS:
  65
  66 ./configure
  67 make
  68
  69 and as root if desired :
  70
  71 make install
  72
  73 BUILDING RPMS:
  74
  75 RPMs may be built by:
  76
  77 after autogen.sh or configure
  78
  79 make dist
  80 rpm -ta vorbis-tools-<version>.tar.gz