Installing Emacspeak and DECtalk software on a Debian system



Author : Nath

Date : 03/04/2003



Introduction

This installation has been succesfully tested on a Debian Woody environment but can be also performed on Sarge or Sid.
Ensure that C and C++ environment is installed on your system.
If they are not installed by default, install the tcl8.3 and tclx8.3 packages by running the following command as root :
/$>apt-get install tcl8.3 tclx8.3
Also verify that Emacs21 is present too !



DECtalk software

How to obtain and install the software

First, you must purchase and download the DECtalk software Runtime for Linux. You will find this software at the following url : http://www.fonix.com/products/dectalk/rt_linux/
Normally you will obtain a .tar.gz file and a serial number.
Copy the .tar.gz file in your HOME directory and, as a normal user, uncompress it :
HOME$>tar xvzf linux_runtime_4.61_intel.tar.gz
A "DECtalk" directory is created. Go to this directory :
HOME$>cd DECtalk
Finally, become root and install the software :
HOME$>su root
passwd
HOME/DECtalk$>./installer
You will be prompted to enter the serial number and after that the software will be installed.


Test

In order to see if DECtalk software works properly you can do the following things :
First we must tell the system where the DECtalk software libraries are located. To do that :
Open the "/etc/ld.so.conf" file in your favorite text editor and add the following line at the bottom :
/usr/local/lib
Save the changes and exit the text editor.
In order to have these changes take effect, run the following command :
/$>ldconfig
Alternatively, as a normal user, open your ".bash_profile" file in your favorite text editor and add the following line at the bottom :
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
Save the changes, exit the text editor and finally log out and log in again.
Now, as a normal user, run the following command :
HOME$>say
If all goes well, you will have the cursor on a blank line and it will be possible to enter a few words which will be spoken as soon as you will press the "enter" key.
Just press Ctrl-c to return to the shell prompt.



Emacspeak and the speech server

How to obtain and install Emacspeak

First you must download the Emacspeak source tree located at the following url : http://prdownloads.sourceforge.net/emacspeak/
NOTA : The last stable release of Emacspeak is 17.0 so the source file is named "emacspeak-17.0.tar.gz".
Place the .tar.gz file you downloaded in your HOME directory and uncompress it :
HOME$>tar xvzf emacspeak-17.0.tar.gz
Change to the emacspeak-17.0 directory :
HOME$>cd emacspeak-17.0
Type the following commands :
HOME/emacspeak-17.0$>make config
HOME/emacspeak-17.0$>make emacspeak
HOME/emacspeak-17.0$>su root
passwd
HOME/emacspeak-17.0$>make install


Compiling the speech server

Go to the directory where the speech server source files have been installed. The file which will be compiled is named "tcldtk.c".
/$>cd /usr/share/emacs/site-lisp/emacspeak/servers/software-dtk/
A "Makefile" is located in this directory and we are going to modify this "Makefile" in order to be able to compile the speech server succesfully on Debian.
So, in your favorite text editor, edit the "Makefile" and modify it as follow according to the Debian version you are running :
The original "Makefile" looks like this :
#$Id: Makefile,v 17.0 2002/11/23 01:29:10 raman Exp $#
CFLAGS=-g -fpic
CC=gcc
LIBS=-ltts -ltts_us -ltcl
tcldtk.so: tcldtk.o $(CC) $< $(LIBS) -shared -o $@
clean: rm tcldtk.so tcldtk.o

For the Debian Woody, modify the "Makefile" as follow :
#$Id: Makefile,v 17.0 2002/11/23 01:29:10 raman Exp $#
CFLAGS=-g -fpic -I /usr/include/tcl8.3
CC=gcc-3.0
LIBS=-ltts -ltts_us -ltcl8.3
tcldtk.so: tcldtk.o $(CC) $< $(LIBS) -shared -o $@
clean: rm tcldtk.so tcldtk.o

for the Debian Sarge and Sid, modify it as follow :
#$Id: Makefile,v 17.0 2002/11/23 01:29:10 raman Exp $#
CFLAGS=-g -fpic -I /usr/include/tcl8.3
CC=gcc
LIBS=-ltts -ltts_us -ltcl8.3
tcldtk.so: tcldtk.o $(CC) $< $(LIBS) -shared -o $@
clean: rm tcldtk.so tcldtk.o

Finally, compile the speech server by typing :
/usr/share/emacs/site-lisp/emacspeak/servers/software-dtk/$>make


Test

To test the speech server, it is necessary to edit your ".bash_profile" file in your favorite text editor and to add the following line at its bottom :
export EMACSPEAK_DIR=/usr/share/emacs/site-lisp/emacspeak
Don't forget to save changes before exiting the text editor and to log out and log in again in order to have changes take effect.
Now, run the following command :
HOME$>tcl /usr/share/emacs/site-lisp/emacspeak/servers/dtk-soft
If all goes well you will obtain a tcl prompt and a few words will be spoken.
To return to the shell prompt, simply type two times ctrl-shift-d



Running Emacspeak with DECtalk software

If all goes well till now, CONGRATULATIONS !
You can now run emacspeak with DECtalk software by typing the following command as a normal user :
HOME$>emacspeak -d
If you prefer, you can initialise the DTK_PROGRAM environment variable in order to specify that DECtalk software is your default speech server. To do so, simply edit your ".bash_profile" file in your favorite text editor and add the following line at its bottom :
export DTK_PROGRAM=dtk-soft
Don't forget to save changes before exiting the text editor and to log out and log in again in order to have changes take effect.
Now to run Emacspeak, simply type :
HOME$>emacspeak



Help

To obtain more help you can visit the Emacspeak Web page http://emacspeak.sourceforge.net/ and particularly the Emacspeak mailing list archives http://www.cs.vassar.edu/~priestdo/emacspeak/.
You can also subscribe to the Emacspeak mailing list by sending a blank message to emacspeak-request@cs.vassar.edu with the word "subscribe" in the subject.