
 Liquidsoap 0.9.2
 ----------------

 Mandatory dependencies :

   ocaml-dtools>=0.1.6
   ocaml-duppy>=0.3.1
   ocaml-pcre

 Optional dependencies :

   ocaml-cry>=0.1.1         for sending to Shoutcast & Icecast
   ocaml-ogg>=0.3.1
   ocaml-vorbis>=0.5.1      for Vorbis data
   ocaml-theora>=0.1.2      for Theora data
   ocaml-speex>=0.1.2       for Speex data
   ocaml-mad>=0.3.6         for MP3 decoding
   ocaml-lame>=0.2.4        for MP3 encoding
   ocaml-taglib>=0.1.3      for MP3ID3 metadata access
   ocaml-faac>=0.1.2        for AAC encoding
   ocaml-faad>=0.1.3        for AAC stream decoding
   ocaml-gavl>=0.1.2        for video conversion using the gavl library
   ocaml-pulseaudio>=0.1.1  for PulseAudio I/O
   ocaml-samplerate>=0.1.1  for libsamplerate audio conversion
   ocaml-lastfm>=0.2.0      for lastfm protocol support
   xml-light>=2.2           for lastfm protocol support
   ocaml-magic>=0.6         for file type detection
   ocaml-xmlplaylist>=0.1.2 for XML-based playlist formats
   ocaml-soundtouch>=0.1.5  for libsoundtouch's audio effects
   ocaml-ao>=0.1.9          for output via libao
   ocaml-alsa>=0.1.4        for ALSA I/O
   ocaml-portaudio>=0.1.3   for Portaudio I/O
   ocaml-bjack>=0.1.3       for Jack support
   ocaml-ladspa>=0.1.2      for LADSPA plugins
   camomile                 for charset recoding in metadata
   ocaml-jack>=0.1.0        for old Jack support (DEPRECATED)
   libopal                  for receiving VOIP calls (EXPERIMENTAL)

   Other optional dependencies can be found in the download
   section of the project. All of them should be included in
   the -full tarball

 Runtime optional dependencies :

   festival, sox, normalize for speech synthesis
   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

 And 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)

 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 radio programming. I hope you'll have fun.
