1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
Liquidsoap 1.1.1
----------------
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, ocaml-magic, ocaml-sdl
camomile, json-wheel, camlimages, gd4o
Mandatory dependencies :
ocaml-dtools>=0.3.1
ocaml-duppy>=0.5.1
ocaml-mm>=0.2.1
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.2 for sending to Shoutcast & Icecast
ocaml-ogg>=0.4.5 for Ogg codecs
ocaml-vorbis>=0.6.1 for Ogg/Vorbis codec
ocaml-opus>=0.1.0 for Ogg/Opus codec
ocaml-theora>=0.3.0 for Ogg/Theora codec
ocaml-speex>=0.2.0 for Ogg/Speex codec
ocaml-flac>=0.1.1 for Flac and Ogg/Flac codec
ocaml-schroedinger>=0.1.0 for Ogg/Schroedinger codec
ocaml-mad>=0.4.4 for MP3 decoding
ocaml-lame>=0.3.2 for MP3 encoding
ocaml-shine>=0.1.0 for fixed-point MP3 encoding
ocaml-taglib>=0.3.1 for MP3ID3 metadata access
ocaml-faad>=0.3.2 for AAC stream decoding
ocaml-aacplus>=0.2.1 for AAC+ encoding
ocaml-voaacenc>=0.1.0 for AAC encoding
ocaml-fdkaac>=0.1.0 for AAC(+) encoding (replacement candidate for voaac and aacplus)
camlimages>=4.0.0 for image decoding
ocaml-sdl for display, font & image support
ocaml-gavl>=0.1.5 for video conversion using the gavl library
ocaml-ffmpeg>=0.1.0 for video conversion using the ffmpeg library
ocaml-samplerate>=0.1.2 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.1 for DSSI sound synthesis
ocaml-frei0r>=0.1.0 for frei0r plugins
ocaml-lo>=0.1.0 for OSC (Open Sound Control) support
ocaml-ladspa>=0.1.4 for LADSPA plugins
ocaml-soundtouch>=0.1.7 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.2 for PulseAudio I/O
ocaml-bjack>=0.1.4 for Jack support
ocaml-gstreamer>=0.2.0 for GStreamer input, output and encoding/decoding
ocaml-inotify>=1.0 for reloading playlists when changed
json-wheel for parsing JSON data (of_json function)
gd4o for video.add_text() on servers without X
Runtime optional dependencies :
wget for http/https/ftp 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.
% make install
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!
|
