Instructions for installing Festival:
-------------------------------------

Other help: http://www.geocities.com/robm351/faq/index-24.html

Files you need for Festival:

festival-1.4.2-release.tar.gz
speech_tools-1.2.2-release.tar.gz
festdoc-1.4.2.tar.gz
festvox_kallpc16k.tar.gz
festvox_kedlpc16k.tar.gz
festvox_rablpc16k.tar.gz
festvox_us1.tar.gz
festvox_don.tar.gz
festlex_CMU.tar.gz
festlex_OALD.tar.gz
festlex_POSLEX.tar.gz

You can get them here: http://www.festvox.org/packed/festival/1.4.2/
Home page for Festival is: http://www.festvox.org/


To install:
    * Become root and create an installation directory
    * Download files mentioned above into this directory
    * Untar festival-1.4.2-release.tar.gz
    * Untar speech_tools-1.2.2-release.tar.gz
    * There are now two directories festival and speech_tools
    * Go to directory speech_tools
    * Type in console: ./configure
    * Type in console: gmake
    * To test the speech tools after compilation type in console: gmake test
    * To install the speech tools type in console: gmake install
    * Go to directory festival
    * Type in console: ./configure
    * Type in console: gmake
    * Go up one directory (cd ..)
    * Untar the other tarballs in this directory
    * To test festival go to festival directory and type in console: gmake test
    * To install festival type in console: gmake install
    * Become user that will use Festival
    * Edit your shellrc file to contain the following:
	path=<festivall-install-dir>/festival/bin:$PATH 
    * Relogin user
    * Start festival server by typing festival_server


To setup MBROLLA:
    * Go to: http://leb.net/pub/blinux/mbrola/mirror.mbrola_home/
    * Download the following files into a new directory:
	mbr301h.zip <- MBROLLA binaries for Linux
	voices/en1/en1.zip  <- English Male voice
	voices/us1/us1.zip  <- American Female voice
    * Unzip mbr301h.zip and copy "mbrola-linux-i386" to your festival bin dir
    * Symlink "mbrola-linux-i386" in the bin dir to "mbrola"
    * Unzip en1.zip
    * Move the en1 directory to $FESTHOME/festival/lib/voices/english/en1_mbrola
    * Unzip us1.zip
    * Move the us1 directory to $FESTHOME/festival/lib/voices/english/us1_mbrola

MBROLA Home Page: http://tcts.fpms.ac.be/synthesis/mbrola.html

-----------------------------------------------------------------------------------
Using Festival:

Method 1:
	* Start Festival via: festival -i
	* Speak with the command: (SayText "Good morning, welcome to Festival")
	* Change voices with the command: (voice_us1_mbrola)
	* Voices are found in $FESTHOME/festival/lib/voices/english/ and are used
		in the form: voice_(voice_directory)

Method 2:
	* Use the Festival command: text2wave 
	* Ex: text2wave -o output.wav text.to.speak.txt
	* You can change voices like this:
		text2wave -o output.wav text.to.speak.txt -eval "(voice_us1_mbrola)"

Method 3: 
	* Use a PERL module such as Festival::Client
	* Code ex:
	-------------------------------------------------------	
   	use Festival::Client;
   	$Festival = Festival::Client->New("my.festival.server");
   	$Festival->say("Something to say");
	-------------------------------------------------------
	* Other modules exist.

------------------------------------------------------------------------------------