// Installing app_cepstral With Asterisk HOWTO
//
// by natas
//
// http://www.oldskoolphreak.com


Last Update: Feb 14, 2006

Cepstral is a text to speech engine that I heard was much better than its free,
open source alternative, Festival. Cepstral amazed me at how easy it was to
install on my linux box. There is a simple install script that takes care of 
everything...or almost everything.

First go to Cepstral's website (http://www.cepstral.com) and choose the voice
you wish to use. Play around with the demos until you find one that you like.
I chose David. Untar the file and cd into its directory. Run the install 
program by doing:

./install.sh

It will ask you to agree to the license and choose your installation directory
which by default is /opt/swift/.

Now that Cepstral is installed you will have to install or rebuild Asterisk for
app_cepstral support. Download the app_cepstral tar.gz file from 
http://www.automated.it/asterisk/ and untar it. If you are running the latest SVN
version of Asterisk, edit app_cepstral.c so the asterisk.h file is pointing to
../include/asterisk.h. Also, if you are running Gentoo, you may have to add:

#include <stdio.h>

Above the line that reads:
#include <asterisk/file.h>

Now place the app_cepstral.c file in your asterisk/apps directory which
should be /usr/src/asterisk/apps/. 

Now, edit the Makefile in the apps directory and add:

APPS+=app_cepstral.so

Towards the top of the file where it talks obsolete programs are commented out.
And then after the section that compiles voicemail add:

app_cepstral.so: app_cepstral.c
	$(CC) -D_GNU_SOURCE -shared -Xlinker -x -o $@ $< -lz -lm -lswift -lceplex_us -lceplang_en -lz -ldl -L/opt/swift/lib -I/opt/swift/include

Make sure the $(CC) line starts with a tab, not spaces. If you are running the
latest SVN version of Asterisk, the Makefile will be different than the previous
1.0 version Makefile. You can simply add these three lines in, above the section
about unixODBC voicemail storage, that's commented out.

Now you can cd .. into the main Asterisk directory and make clean ; make install.

Now that Asterisk is installed/rebuilt, make sure your /etc/ld.so.conf file has
/opt/swift/libs in a line at the end. If not make sure to add it and run 
ldconfig when done. I'm not sure if all new version of Cepstral have different
directory names, or if it's just because I'm running Gentoo, but I had to add
/opt/swift/lib to my /etc/ld.so.conf - not /opt/swift/libs. You should do an
ls /opt/swift/ to see what the directory is named on your system.

You may now start up Asterisk. Use Cepstral in your dial plan by doing something
like this:

exten => 1000,1,Cepstral(your text here!)

Now don't forget that Cepstral isn't free so if you want to make the most of it
licenses are available for $30 per voice. If you do buy a license, you can run
the registration program by doing:

swift --register

Enjoy!

Shouts to BlackRatchet for his help when I was trying to install this and for his
continued support when it broke and I needed even more help!