.TH  FESTIVAL 1 "6th Apr 1998"
.SH NAME
festival \- a text-to-speech system.
.SH SYNOPSIS
.B festival 
.I [options]
.I [file0]
.I [file1]
.I ...


.SH DESCRIPTION
Festival is a general purpose text-to-speech system.  As well as 
simply rendering text as speech it can be used in an interactive
command mode for testing and developing various aspects of speech
synthesis technology.

Festival has two major modes, command and tts (text-to-speech).
When in command mode input (from file or interactively) is interpreted
by the command interpreter.  When in tts mode input is rendered as 
speech.  When in command mode filenames that start with a left
parenthesis are treated as literal commands and evaluated.

.SH OPTIONS


.TP 8
.BI "-q " 
Load no default setup files 
.TP 8
.BI "\-\-datadir " <string>
Set data directory pathname 
.TP 8
.BI "\-\-libdir " <string>
Set library directory pathname 
.TP 8
.BI "-b " 
Run in batch mode (no interaction) 
.TP 8
.BI "\-\-batch " 
Run in batch mode (no interaction) 
.TP 8
.BI "\-\-tts " 
Synthesize text in files as speech 
no files means read from stdin 
(implies no interaction by default) 
.TP 8
.BI "-i " 
Run in interactive mode (default) 
.TP 8
.BI "\-\-interactive " 
Run in interactive mode (default) 
.TP 8
.BI "\-\-pipe " 
Run in pipe mode, reading commands from 
stdin, but no prompt or return values 
are printed (default if stdin not a tty) 
.TP 8
.BI "\-\-language " <string>
Run in named language, default is 
english, spanish, russian, welsh and others are available 
.TP 8
.BI "\-\-server " 
Run in server mode waiting for clients 
of server_port (1314) 
.TP 8
.BI "\-\-script " 
<ifile> 
Used in #! scripts, runs in batch mode on 
file and passes all other args to Scheme 
.TP 8
.BI "\-\-heap " <int> " {10000000}"
Set size of Lisp heap, should not normally need 
to be changed from its default 
.TP 8
.BI "-v " 
Display version number and exit 
.TP 8
.BI "\-\-version " 
Display version number and exit 
.SH BUGS
More than you can imagine.  

A manual with much detail (though not complete) is available
in distributed as part of the system and is also accessible at
.br
http://www.cstr.ed.ac.uk/projects/festival/manual/

Although we cannot guarantee the time required to fix bugs, we
would appreciated it if they were reported to 
.br
festival-bug@cstr.ed.ac.uk

.SH AUTHOR
Alan W Black, Richard Caley and Paul Taylor
.br
(C) Centre for Speech Technology Research, 1996-1998
.br
University of Edinburgh
.br
80 South Bridge
.br
Edinburgh EH1 1HN
.br
http://www.cstr.ed.ac.uk/projects/festival.html