a6a7c067caef96a7d4241882dcdb35396e5bbc78
[asterisk/asterisk.git] / contrib / README.festival
1
2 app_festival is an application that allows one to send text-to-speech commands
3 to a background festival server, and to obtain the resulting waveform which
4 gets sent down to the respective channel. app_festival also employs a waveform 
5 cache, so invariant text-to-speech strings ("Please press 1 for instructions") 
6 do not need to be dynamically generated all the time. 
7
8 You need : 
9
10 1) festival, patched to produce 8khz waveforms on output. Patch for Festival
11 1.4.2 RELEASE are included. The patch adds a new command to festival 
12 (asterisk_tts). 
13
14
15 2) You may wish to obtain and install the asterisk-perl
16 module by James Golovich <james@gnuinter.net>, from 
17 either CPAN, or his site: http://asterisk.gnuinter.net,
18 as this contains a good example of how variable text
19 can be tts'd via asterisk, namely the examples/tts-*.agi
20 files there. It has been noted that the current expression
21 evaluation capabilities of asterisk are not best suited
22 for the generation and manipulation of text. AGI scripting
23 can be ideal for these sorts of needs. For simpler usage,
24 fixed, pre-recorded messages may be more amenable for your
25 purposes.
26
27 3) Before running asterisk, you have to run festival-server with a command 
28 like : 
29
30 /usr/local/festival/bin/festival --server > /dev/null 2>&1 &