
 Liquidsoap 1.0.0 beta3
 ------------------------

 Below is a list of dependencies, mostly OCaml libraries.
 Optional libraries provide extra features. They need to be detected
 by the "configure" script.

 Most of the libraries are developed by the Savonet project and,
 in addition to being available through traditional distribution
 channels, are bundled in the liquidsoap-<version>-full.tar.bz2 tarballs
 for easier builds.

 Libraries not developed by Savonet are:
   ocaml-pcre, camomile, ocaml-magic, json-wheel


 Mandatory dependencies :

   ocaml-dtools>=0.2.2
   ocaml-duppy>=0.4.1
   ocaml-mm>=0.1.0
   ocaml-pcre

 Recommended dependencies :

   camomile                 for charset recoding in metadata
   ocaml-magic>=0.6         for file type detection
   festival, sox, normalize for speech synthesis

 Optional dependencies :

   ocaml-cry>=0.2.1          for sending to Shoutcast & Icecast
   ocaml-ogg>=0.4.2          for Ogg codecs
   ocaml-vorbis>=0.6.0       for Ogg/Vorbis codec
   ocaml-theora>=0.3.0       for Ogg/Theora codec
   ocaml-speex>=0.2.0        for Ogg/Speex codec
   ocaml-flac>=0.1.0         for Flac and Ogg/Flac codec
   ocaml-schroedinger>=0.1.0 for Ogg/Schroedinger codec
   ocaml-mad>=0.4.2          for MP3 decoding
   ocaml-lame>=0.3.0         for MP3 encoding
   ocaml-taglib>=0.1.4       for MP3ID3 metadata access
   ocaml-faad>=0.3.3         for AAC stream decoding
   ocaml-aacplus>=0.2.0      for AAC(+) encoding
   ocaml-voaacenc>=0.2.0     for AAC(+) encoding
   ocaml-gavl>=0.1.4         for video conversion using the gavl library
   ocaml-samplerate>=0.1.1   for libsamplerate audio conversion
   ocaml-lastfm>=0.3.0       for lastfm protocol support
   ocaml-xmlplaylist>=0.1.3  for XML-based playlist formats
   ocaml-dssi>=0.1.0         for DSSI sound synthesis
   ocaml-lo>=0.1.0           for OSC (Open Sound Control) support
   ocaml-ladspa>=0.1.3       for LADSPA plugins
   ocaml-soundtouch>=0.1.6   for libsoundtouch's audio effects
   ocaml-ao>=0.2.0           for output via libao
   ocaml-alsa>=0.2.1         for ALSA I/O
   ocaml-portaudio>=0.2.0    for Portaudio I/O
   ocaml-pulseaudio>=0.1.1   for PulseAudio I/O
   ocaml-bjack>=0.1.3        for Jack support
   ocaml-jack [unreleased]   for old Jack support (DEPRECATED)
   json-wheel                for parsing JSON data (of_json function)

 Runtime optional dependencies :

   wget for http/https/ftp support
   ufetch (from ocaml-fetch) for smb support

 How to install
 --------------

 *BSD users, as well as OSX users might need to export some variables 
 that can be missing during the process:
   % export CPPFLAGS=-I/usr/local/include
   % export LDFLAGS=-L/usr/local/lib
   % export OCAMLMKLIB_FLAGS=-L/usr/local/lib 
 Also, liquidsoap needs GNU make. If you have a GNU make, this is normally
 detected during configuration. If this check fails you can set the MAKE
 variable:
   % export MAKE=`your make command`

 The following assumes your MAKE command is make. Change to yours if
 different.

 Now you can start the build configuration:
   % ./configure

 If you want a complete installation of liquidsoap, enabling a production
 use of liquidsoap as a daemon, you should pass --with-user=<login> and
 --with-group=<group> options to indicate which user/group you have
 created for liquidsoap.

 Then, build the software:
   % make

 You can also generate the documentation for liquidsoap:
   % make doc

 It will generate the HTML documentation, including a version of the scripting
 API reference corresponding to your configuration. If Perl's module XML::DOM
 is not available it only generate a stub reference and issue a warning.

 Then, you may proceed to the installation. You may need to be root for that.
 Also, user and group liquidsoap should be created prior to installation.
 If you want to use other user/groups, please edit Makefile.defs -- unless
 you prefer to re-run the configure script with the proper --with-user/group.

   % make install (as root if needed)

 This will not install files such as /var/log/liquidsoap unless you have
 provided a user/group under which liquidsoap should be ran. This behavior
 can be overridden by passing INSTALL_DAEMON="yes" (useful for preparing
 binary packages).

 For installing developers documentation, run:

   % make api-doc-install

 Then if you want services to be installed in $prefix/etc/init.d, run one of
 the following. service is for a generic /bin/sh service, gentoo is for
 a gentoo compliant service, to be used iff you've a gentoo linux.

   % make (service|gentoo)-install

 See /doc for understanding liquidsoap scripting. Have fun!
