README

   1 This is libsndfile, 1.0.29
   2
   3 libsndfile is a library of C routines for reading and writing
   4 files containing sampled audio data.
   5
   6 The src/ directory contains the source code for library itself.
   7
   8 The doc/ directory contains the libsndfile documentation.
   9
  10 The examples/ directory contains examples of how to write code using
  11 libsndfile.
  12
  13 The tests/ directory contains programs which link against libsndfile
  14 and test its functionality.
  15
  16 The src/GSM610 directory contains code written by Jutta Degener and Carsten
  17 Bormann. Their original code can be found at :
  18     http://kbs.cs.tu-berlin.de/~jutta/toast.html
  19
  20 The src/G72x directory contains code written and released by Sun Microsystems
  21 under a suitably free license.
  22
  23 The src/ALAC directory contains code written and released by Apple Inc and
  24 released under the Apache license.
  25
  26
  27 LINUX
  28 -----
  29 Whereever possible, you should use the packages supplied by your Linux
  30 distribution.
  31
  32 If you really do need to compile from source it should be as easy as:
  33
  34                 ./configure
  35                 make
  36                 make install
  37
  38 Since libsndfile optionally links against libFLAC, libogg, libvorbis and
  39 libopus, you will need to install appropriate versions of these libraries
  40 before running configure as above.
  41
  42 You can use CMake now to build under Linux, also under Windows and MacOS, see
  43 README.md for details. CMake toolchain is usable, but still exterimental.
  44
  45
  46 UNIX
  47 ----
  48 Compile as for Linux.
  49
  50
  51 Win32/Win64
  52 -----------
  53
  54 Official Windows binaries are compiled with Autotools and MinGW, but you can use
  55 CMake to generate solution for Visual Studio. Details are described in
  56 README.md.
  57
  58 It is still recommended to use the libsndfile binaries available on the
  59 libsndfile web site.
  60
  61 MacOSX
  62 ------
  63 Building on MacOSX should be the same as building it on any other Unix.
  64
  65
  66 CONTACTS
  67 --------
  68
  69 libsndfile was written by Erik de Castro Lopo (erikd AT mega-nerd DOT com).
  70 The libsndfile home page is at :
  71
  72         http://libsndfile.github.io/libsndfile/
  73
  74 Bugs and support questions can be raised at :
  75
  76         https://github.com/libsndfile/libsndfile/issues