speech-dispatcher: Installation

 
 2.1 Installation
 ================
 
 This part only deals with the general aspects of installing Speech
 Dispatcher.  If you are compiling from source code (distribution tarball
 or git), please refer to the file 'INSTALL' in your source tree.
 
 2.1.1 The requirements
 ----------------------
 
 You will need these components to run Speech Dispatcher:
    * glib 2.0 (<http://www.gtk.org>)
    * libdotconf 1.3 (<http://github.com/williamh/dotconf>)
    * pthreads
 
    We recommend to also install these packages:
    * Festival (<http://www.cstr.ed.ac.uk/projects/festival/>)
    * festival-freebsoft-utils 0.3+
      (<http://www.freebsoft.org/festival-freebsoft-utils>)
    * Sound icons library
      (<http://www.freebsoft.org/pub/projects/sound-icons/sound-icons-0.1.tar.gz>)
 
 2.1.2 Recommended installation procedure
 ----------------------------------------
 
    * Install your software synthesizer
 
      Although we highly recommend to use Festival for its excellent
      extensibility, good quality voices, good responsiveness and best
      support in Speech Dispatcher, you might want to start with eSpeak,
      a lightweight multi-lingual feature-complete synthesizer, to get
      all the key components working and perhaps only then switch to
      Festival.  Installation of eSpeak should be easier and the default
      configuration of Speech Dispatcher is set up for eSpeak for this
      reason.
 
      You can of course also start with Epos or any other supported
      synthesizer.
 
    * Make sure your synthesizer works
 
      There is usually a way to test if the installation of your speech
      synthesizer works.  For eSpeak run 'espeak "test"', for Flite run
      'flite -t "Hello!"' and hear the speech.  For Festival run
      'festival' and type in
 
           (SayText "Hello!")
           (quit)
 
    * Install Speech Dispatcher
 
      Install the packages for Speech Dispatcher from your distribution
      or download the source tarball (or git) from
      <http://www.freebsoft.org/speechd> and follow the instructions in
      the file 'INSTALL' in the source tree.
 
    * Configure Speech Dispatcher
 
      You can skip this step in most cases.  If you however want to setup
      your own configuration of the Dispatchers default values, the
      easiest way to do so is through the 'spd-conf' configuration
      script.  It will guide you through the basic configuration.  It
      will also subsequently perform some diagnostics tests and offer
      some limited help with troubleshooting.  Just execute
 
           spd-conf
 
      under an ordinary user or system user like 'speech-dispatcher'
      depending on whether you like to setup Speech Dispatcher as user or
      system service respectively.  You might also want to explore the
      offered options or run some of its subsystems manually, type
      'spd-conf -h' for help.
 
      If you do not want to use this script, it doesn't work in your case
      or it doesn't provide enough configuration flexibility, please
      continue as described below and/or in ⇒Running Under Ordinary
      Users.
 
    * Test Speech Dispatcher
 
      The simplest way to test Speech Dispatcher is through 'spd-conf -d'
      or through the 'spd-say' tool.
 
      Example:
           spd-conf -d
           spd-say "Hello!"
           spd-say -l cs -r 90 "Ahoj"
 
      If you don't hear anything, please ⇒Troubleshooting.
 
 2.1.3 How to use eSpeak NG or eSpeak with MBROLA
 ------------------------------------------------
 
 Please follow the guidelines at
 <https://github.com/espeak-ng/espeak-ng/blob/master/docs/mbrola.md>
 (resp.  <http://espeak.sourceforge.net/mbrola.html>) for installing
 eSpeak NG (resp.  eSpeak) with a set of MBROLA voices that you want to
 use.
 
    Check the 'modules/espeak-ng-mbrola-generic.conf' (resp.
 'modules/espeak-mbrola-generic.conf') configuration files for the
 'AddVoice' lines.  If a line for any of the voices you have installed
 (and it is supported by your version of eSpeak NG (resp.  eSpeak), e.g.
 'ls /usr/lib/*/espeak-ng-data/voices/mb/mb-*' (resp.  'ls
 /usr/lib/*/espeak-data/voices/mb/mb-*')) is not contained here, please
 add it.  Check if 'GenericExecuteString' contains the correct name of
 your mbrola binary and correct path to its voice database.
 
    Restart speech-dispatcher and in your client, select
 'espeak-ng-mbrola-generic' (resp.  'espeak-mbrola-generic') as your
 output module, or test it with the following command
 
      spd-say -o espeak-ng-mbrola-generic -l cs Testing
 
    (resp.
      spd-say -o espeak-mbrola-generic -l cs Testing
    )