FishSound, the sound of fish!
-----------------------------

  Full documentation is available in doc/fishsound/html/index.html,
  or online at http://www.annodex.net/software/libfishsound/html/

  Updates are available online at the FishSound homepage:
  http://www.annodex.net/software/libfishsound/

libfishsound provides a simple programming interface for decoding and
encoding audio data using Xiph.Org codecs (FLAC, Speex and Vorbis).

libfishsound by itself is designed to handle raw codec streams from a
lower level layer such as UDP datagrams. When these codecs are used in
files, they are commonly encapsulated in Ogg to produce Ogg FLAC, Speex
and Ogg Vorbis files.

libfishsound is a wrapper around the existing codec libraries and provides
a consistent, higher-level programming interface. It has been designed for
use in a wide variety of applications; it has no direct dependencies on
Ogg encapsulation, though it is most commonly used in conjunction with
liboggz to decode or encode FLAC, Speex or Vorbis audio tracks in Ogg files,
including Ogg Theora and Annodex.

This source tarball
-------------------

FishSound has been developed and tested on GNU/Linux, Darwin/MacOSX and
Win32. It probably also works on other Unix-like systems via GNU autoconf.
For Win32: nmake Makefiles, Visual Studio .NET 2003 solution files and
Visual C++ 6.0 workspace files are all provided in the source distribution.

Details for building with GNU autotools are in the file INSTALL. Read the
file README.win32 for installing under MS Windows.

  src/libfishsound/  the library source code.
  src/examples/      example tools for programming with libfishsound.
 
  include/           the libfishound include files that will be installed
                     into the system include directory.

  doc/               documentation for libfishsound. The subdirectory
                     doc/libfishsound is autocreated by doxygen from
		     comments contained in <fishsound/fishsound.h>
  
  win32/             files necessary to compile under MS Windows.

Developers
----------

libfishsound is maintained in git at git://git.xiph.org/libfishsound.git

A list of outstanding tasks is maintained in the TODO file of this source
distribution. When implementing anything listed in this file, please update
it by deleting that entry, and include that as part of the patch or commit
that implements the fix.

Please send patches to vorbis-dev@xiph.org. Codec-specific patches can be
sent to the appropriate list, eg. speex-dev@xiph.org or flac-dev@xiph.org.

Contact
-------

The lead developer is Conrad Parker <conrad@metadecks.org>,
kfish on #vorbis, #speex on irc.freenode.net.