asterisk/contrib
Automerge script 01250e2585 Merged revisions 378410,378412,378414 via svnmerge from
file:///srv/subversion/repos/asterisk/trunk

................
  r378410 | mjordan | 2013-01-03 09:37:31 -0600 (Thu, 03 Jan 2013) | 13 lines
  
  Prevent crashes in res_xmpp when receiving large messages
  
  Similar to r378287, res_xmpp was marshaling data read from an external source
  onto the stack. For a sufficiently large message, this could cause a stack
  overflow. This patch modifies res_xmpp in a similar fashion to res_jabber by
  removing the stack allocation, as it was unnecessary.
  
  (issue ASTERISK-20658)
  Reported by: wdoekes
  ........
  
  Merged revisions 378409 from http://svn.asterisk.org/svn/asterisk/branches/11
................
  r378412 | file | 2013-01-03 09:40:21 -0600 (Thu, 03 Jan 2013) | 11 lines
  
  Prevent exhaustion of system resources through exploitation of event cache
  
  This patch changes res_xmpp to no longer cache events under certain circumstances.
  
  (issue ASTERISK-20175)
  Reported by: Russell Bryant, Leif Madsen, Joshua Colp
  Tested by: kmoore
  ........
  
  Merged revisions 378411 from http://svn.asterisk.org/svn/asterisk/branches/11
................
  r378414 | tilghman | 2013-01-03 10:04:11 -0600 (Thu, 03 Jan 2013) | 11 lines
  
  Add aliases to the Directory.
  
  This is an interesting feature that allows additional strings to be used to
  search the Directory, primarily intended to be used with nicknames, but could
  be used with affiliations and the like.  Because the name field is used in
  more than one place (such as email notifications), it is important that these
  additional strings not be placed in the name field, but be specified
  separately.
  
  Review: https://reviewboard.asterisk.org/r/2244/
................


git-svn-id: https://origsvn.digium.com/svn/asterisk/team/mmichelson/threadpool@378422 65c4cc65-6c06-0410-ace0-fbb531ad65f3
2013-01-03 16:19:40 +00:00
..
editors Also have vim syntax-highlight type=network. 2012-06-04 20:53:43 +00:00
init.d Added clarification for the VERBOSITY setting to etc_default_asterisk 2012-02-01 15:07:24 +00:00
realtime Merged revisions 378410,378412,378414 via svnmerge from 2013-01-03 16:19:40 +00:00
scripts Merged revisions 378259 via svnmerge from 2013-01-01 19:19:12 +00:00
thirdparty remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
unistimLang Add French translation for chan_unistim phones on-screen menus. 2012-07-16 07:34:12 +00:00
upstart Change all refererences to 1.6.3 to be 1.8, since that will be the next feature release 2009-12-21 18:51:17 +00:00
utils clean up a bunch more Zaptel-related references 2008-07-11 16:18:01 +00:00
README.festival remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
asterisk-doxygen-header remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
asterisk-ices.xml remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
asterisk-ng-doxygen Doxygen Updates - Title update 2012-10-18 14:17:40 +00:00
dictionary.digium Add support for logging CDR recrods to a radius server (issue #6639, phsultan) 2006-05-20 22:30:05 +00:00
festival-1.4.1-diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.4.2.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.4.3.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
festival-1.95.diff remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
i18n.testsuite.conf Merged revisions 170671 via svnmerge from 2009-01-23 20:23:00 +00:00
valgrind-RedHat-8.0.supp remove extraneous svn:executable properties 2005-11-29 18:24:39 +00:00
valgrind.supp Line 24 missed in compatibility fix in revision 233577 2010-04-26 19:05:47 +00:00

README.festival

app_festival is an application that allows one to send text-to-speech commands
to a background festival server, and to obtain the resulting waveform which
gets sent down to the respective channel. app_festival also employs a waveform 
cache, so invariant text-to-speech strings ("Please press 1 for instructions") 
do not need to be dynamically generated all the time. 

You need : 

1) festival, patched to produce 8khz waveforms on output. Patch for Festival
1.4.2 RELEASE are included. The patch adds a new command to festival 
(asterisk_tts). 

It is possible to run Festival without patches in the source-code. Just
add this to your /etc/festival.scm or /usr/share/festival/festival/scm:

    (define (tts_textasterisk string mode)
    "(tts_textasterisk STRING MODE)
    Apply tts to STRING. This function is specifically designed for
    use in server mode so a single function call may synthesize the string.
    This function name may be added to the server safe functions."
    (let ((wholeutt (utt.synth (eval (list 'Utterance 'Text string)))))
    (utt.wave.resample wholeutt 8000)
    (utt.wave.rescale wholeutt 5)
    (utt.send.wave.client wholeutt)))

[See the comment with subject "Using Debian
 festival >= 1.4.3-15 (no recompiling needed!)" on
 http://www.voip-info.org/wiki-Asterisk+festival+installation for the
 original mentioning of it]

2) You may wish to obtain and install the asterisk-perl
module by James Golovich <james@gnuinter.net>, from 
either CPAN, or his site: http://asterisk.gnuinter.net,
as this contains a good example of how variable text
can be tts'd via asterisk, namely the examples/tts-*.agi
files there. It has been noted that the current expression
evaluation capabilities of asterisk are not best suited
for the generation and manipulation of text. AGI scripting
can be ideal for these sorts of needs. For simpler usage,
fixed, pre-recorded messages may be more amenable for your
purposes.

3) Before running asterisk, you have to run festival-server with a command 
like : 

/usr/local/festival/bin/festival --server > /dev/null 2>&1 &