
CHAPTER 2
INSTALLING outSPOKEN FOR WINDOWS
Chapter Summary
This chapter provides step-by-step instructions on 
installing outSPOKEN for Windows. Section 2.1 
indicates what to do before beginning to work with 
outSPOKEN's installer. Section 2.2 explains how to 
use the installation program, OSINSTAL.EXE. Section 
2.2 is separated into three sections. Section 2.2.1 
explains how to use the installer from the command 
line and describes the proper format of the 
parameters. This section is recommended if no DOS 
screen reader or sighted assistance is available. 
Section 2.2.2 gives instructions on using the 
interactive installer. This section is recommended if 
you do have a DOS screen reader. Section 2.2.3 
explains the meanings of the tones generated by the 
installer. These tones are extremely informative if 
you do not have a DOS screen reader or a sighted 
assistant. Section 2.3 explains how to install 
outSPOKEN without the installer. This section 
provides details about where outSPOKEN's files are 
stored, what files must be modified for proper 
installation, and alternative ways of installing and 
launching outSPOKEN. This section is not recommended 
for beginners. Section 2.4 gives simple instructions 
for getting started once outSPOKEN is installed. 
2.1	Before Installing outSPOKEN
Before installing outSPOKEN, whether with or without 
the installer, the following three steps must be taken.
1.	Attach your speech synthesizer to your computer 
according to the manufacturer's directions. 
2.	Install the manufacturer's speech synthesizer 
drivers, if any, according to the installation 
directions in the synthesizer's documentation. 
3.	Install Microsoft Windows on your computer with 
the Microsoft Windows master disks (not included 
with outSPOKEN). If you need help with this step, 
more information is available in Appendix C, "Tips 
on Installing Microsoft Windows."
Now you are ready to install outSPOKEN for Windows.
2.2	outSPOKEN's Installer
outSPOKEN's installer is a DOS application called 
OSINSTAL.EXE. It will not talk under its own power. If 
you are accustomed to using a DOS screen reader, we 
strongly recommend launching it before running the 
installer. 
outSPOKEN's installer can be used in two ways: from the 
DOS command line (Section 2.2.1) or as an interactive 
program (Section 2.2.2). If you do have a DOS screen 
reader, the interactive installer is the most 
straightforward method of installation. In this case, 
please skip directly to Section 2.2.2. If you are not 
using a DOS screen reader, and you are not able to read 
the screen without one, the installer uses a series of 
tones to provide feedback on the status of the 
installation process (Section 2.2.3).
The outSPOKEN installer makes changes to three files on 
your hard drive: AUTOEXEC.BAT, WIN.INI, and SYSTEM.INI. 
Before making any changes, the installer makes copies 
of the original files and gives them the file extension 
".OSW". For example, the copy of AUTOEXEC.BAT is named 
AUTOEXEC.OSW. For more information about these 
modifications, read "Installing outSPOKEN Without The 
Installer" (Section 2.3).
2.2.1	The Command Line Installer
The easiest way to install outSPOKEN is to run the 
program OSINSTAL.EXE. 
Insert the outSPOKEN floppy disk into a disk drive. 
Make that drive the current one by typing its drive 
letter, followed by a colon, then pressing oENTER.
Run the installer by typing a line of the following 
form. A detailed explanation of each part of the line 
follows:
OSINSTAL [<outSPOKEN drive letter+path> <Windows 
Path> <Synthesizer Driver> [<Port>]]
Each piece of this command gives OSINSTAL some 
information about how to proceed with the installation. 
All parameters except for the final one, the port 
number, MUST be included or outSPOKEN's installer will 
not run properly. If no port is specified on the 
command line, OSINSTAL.EXE assumes a port number of 0 
(indicating an internal synthesizer). Each separate 
parameter is explained below. For further 
clarification, see the example at the end of this 
section.
outSPOKEN drive letter+path:
This is the letter of the drive on which you want to 
install outSPOKEN, plus the directory to be created 
where outSPOKEN will be stored. The suggested location 
is C:\OSW. 
Windows Path:
This is the path (including drive letter) where 
Microsoft Windows is located. The most common location 
for Windows to be found is C:\WINDOWS.
Synthesizer Driver:
This is the name of the speech synthesizer driver 
needed to link your particular synthesizer to outSPOKEN 
for Windows. Below you will find a list of supported 
synthesizers and their corresponding drivers. If your 
synthesizer is not listed here, be sure to check the 
README file on the outSPOKEN program disk for the most 
recent list of supported synthesizers. 
Synthesizer	Driver
Accent	ACCENT.COM
Apollo	APOLLO.COM
Artic	ARTIC.COM
ASP Synthesizer	ASP.COM
Audapter	AUDAPTER.COM
Braille `n Speak	BNS.COM
DECtalk Classic	DEC-C.COM
DECtalk PC	DECPC.COM
DoubleTalk	DOUBLE.COM
DoubleTalk-LT	DOUBLE.COM
Echo GP	ECHO.COM
KPR	DEC-C.COM
LiteTalk	DOUBLE.COM
MultiVoice	MULTI.COM
New Echo	ECHO-N.COM
PocketBraille	PB.COM
SoundingBoard	SB.COM
VoTalker	ARTIC.COM
Votrax	ARTIC.COM

Port:
This is the number of the port (usually 1-4) of your 
speech synthesizer if it is an external device. If your 
external synthesizer is a serial device, simply use the 
number of the com port to which it is attached. If your 
synthesizer is a parallel device, include a letter "L", 
with no space, before the number of the parallel port 
to which it is attached. If you have an internal speech 
synthesizer, this parameter can be omitted. 

If you've given the install program all the information 
it needs, the installation process is completely 
automatic. As the installation progresses, your 
computer will make several types of tones, providing 
feedback on the status of the installation (Section 
2.2.3). If you are using a DOS screen reader, these 
tones can be ignored. When the installation is 
successful, a series of tones, descending in pitch, 
will sound, and you will be returned to the DOS prompt. 
At this point, you are ready to restart your computer 
and launch Windows. For help in getting started, see 
Section 2.4.
If any of the information given on the command line is 
incorrect, the installer stops at that point and 
proceeds with the interactive installer. For 
information about the prompts and error messages of the 
interactive installer, see the following two sections 
(Sections 2.2.2-3).
Example:
Command line:
OSINSTAL C:\OSW C:\WINDOWS ACCENT 1
Before typing the above command line, insert the 
outSPOKEN disk in the disk drive and type the letter of 
the drive, followed by a colon (no space), then press 
oENTER (e.g., A: oENTER). This makes the drive with the 
outSPOKEN disk in it the current drive. When you are 
prompted by the new drive letter, you are ready to type 
the above command line. The first parameter after 
"OSINSTAL" is "C:\OSW". This tells the installer to 
create a directory on the C drive called "OSW", and to 
copy all the outSPOKEN files to that directory. We 
recommend that you do not change this parameter. The 
next parameter, "C:\WINDOWS", tells the installer to 
look for Windows on drive C, in a directory called 
WINDOWS. This is the default location for Microsoft 
Windows. The third parameter, "ACCENT", specifies that 
the synthesizer driver ACCENT.COM should be used to 
communicate with your synthesizer. This parameter will 
vary depending on your particular synthesizer. Check 
the above list for the appropriate driver for your 
situation. Remember not to include the "COM" part of 
the driver name. The final parameter, "1", indicates 
that the synthesizer is attached to serial port 1. 
If your outSPOKEN disk is in drive B:, change A: in the 
above example to B:. If you want to install outSPOKEN 
to a drive and directory other than C:\OSW, replace the 
letter C in the first parameter after "OSINSTAL" with 
the preferred drive letter, and replace the path name 
OSW with the desired directory. If Microsoft Windows is 
installed in a location other than C:\WINDOWS, replace 
the next parameter of this command line with the 
appropriate location. If you are using a speech 
synthesizer that uses a driver other than ACCENT.COM, 
change the next parameter of the command line from 
"ACCENT" to the appropriate driver (see the above list 
of drivers and synthesizers). If that synthesizer is 
not internal, a port number (1-4) should be specified 
as the final parameter of this command line. If the 
external synthesizer is parallel, include a letter "L" 
before the port number (e.g., "L2"). If the synthesizer 
is internal, you do not need to include the port number 
at the end of the command line. 
2.2.2	The Interactive Installer
This section describes how to use outSPOKEN's installer 
interactively. Remember to perform the steps in "Before 
Installing" (Section 2.1) prior to installing 
outSPOKEN. If you are accustomed to using a DOS screen 
reader, we recommend that you launch it before running 
the interactive installer. If you do not have a DOS 
screen reader, but cannot read the screen without one, 
the next section (Section 2.2.3) describes the 
installer's feedback tones. Another alternative is to 
have a sighted assistant available to read the screen. 
To run the installer, insert the outSPOKEN diskette 
into your A: drive, type the following command, and 
then press oENTER:
A:OSINSTAL
If the outSPOKEN disk is in a drive other than A, 
replace the letter "A" above with the appropriate drive 
letter.
The installer requests the following information:
	"Which drive are you installing outSPOKEN to?"
If you simply press oENTER, outSPOKEN will be installed 
on drive C, in a directory called OSW. If you wish to 
install outSPOKEN elsewhere, type the drive and path of 
the desired location, and press oENTER.
	"In what directory is Windows installed?"
If you simply press oENTER, the installer will look for 
Windows on the C drive, in a directory called WINDOWS. 
If you have Windows located elsewhere, enter the drive 
and path name of your Windows directory, and press 
oENTER.
	"Which speech synthesizer driver should be 
installed?"
The installer requests you to type the name of the 
driver that supports your synthesizer. A list of these 
drivers is displayed on the screen. The list of drivers 
and supported synthesizers can also be found in the 
previous section (Section 2.2.1). If your synthesizer 
is not listed here, check the README file on the 
outSPOKEN disk for up-to-date synthesizer and driver 
information.
 	"Which port is your synthesizer attached to?"
 If you have an external speech synthesizer attached to 
a COM (serial) port, type the number of the port to 
which it is attached. If you have an internal 
synthesizer, type 0 for your port number. If your 
external synthesizer is attached to a parallel port, 
include the letter "L" before the port number.
When the installation is successful, the installer 
plays a series of descending tones, and you are 
returned to the DOS prompt. At this point, you are 
ready to restart your computer and launch Windows. 
2.2.3	Installer Feedback Tones
Although we recommend using a DOS screen reader for the 
installation process, it is possible to run 
OSINSTAL.EXE without running any speech program, even 
if you cannot read the screen. OSINSTAL plays various 
tone sequences to inform you of the installation 
progress. 
There are three basic tone sequences that the installer 
uses: the prompt tones, the progress tones, and the 
error tones.
As the installer proceeds through each step in the 
installation process, you will hear one to four 
ascending progress tones. The first tone is associated 
with the outSPOKEN directory verification, the second 
with the Windows path name, the third with the 
synthesizer driver, and the last with the synthesizer's 
port. If you are running OSINSTAL with command line 
input, as each part of the command line is verified, 
the corresponding tones are played. If the interactive 
installer is being used, each new series of tones will 
indicate what information is being requested. As with 
the command line installer, the first tone indicates 
that you should enter the path for outSPOKEN, the 
second indicates a request for the Windows path, etc. 
For a description of proper responses to these prompts, 
see "The Interactive Installer" (Section 2.2.2). When 
installation is complete, these four tones will sound 
in reverse order (highest to lowest), signalling that 
the installation has been successful, and you will be 
returned to the DOS prompt.
The prompt tones indicate that the installer is waiting 
for you to enter some information. The prompt tones are 
comprised of two quick beeps_first a high one, then a 
low one. If you are running the interactive installer, 
each new progress tone is followed by the prompt tones. 
If you hear the prompt tones when running the command 
line installer, this indicates that one of the pieces 
of information supplied on the command line was 
incorrect. You will know which piece of information you 
are being asked to re-enter by the progress tones 
associated with the prompt. 
The error tones are a set of three or more low, 
ominous-sounding beeps. If one of the pieces of 
information supplied, either on the command line or via 
the interactive installer, is incorrect, a set of three 
tones will sound. The error tones will be followed by 
the prompt tones, and you may re-enter whatever 
information was incorrect. If more than three error 
tones sound, there has been a problem with the file 
copying or modification portion of the installation. If 
you hear error tones, a detailed error message is also 
displayed on the screen. A complete list of the 
meanings of these error tones follows. 
- 3 tones means that an error occurred during 
the verification portion of the 
installation process.
- 5 tones means that there was a problem 
copying files from the source diskette.
- 6 tones means that the installer had a 
problem copying the synthesizer driver.
- 7 tones means that there was a problem 
copying the keyboard driver.
- 8 tones means that the installer was unable 
to modify your WIN.INI file.
- 9 tones means that the installer was unable 
to modify your SYSTEM.INI file.
- 10 tones means that the installer was 
unable to modify your AUTOEXEC.BAT file.
2.3	Installing outSPOKEN Without The Installer
Installing outSPOKEN without the installer is a 
relatively simple process. It is equivalent to running 
OSINSTAL, but it does require the use of a text editor 
and some knowledge of DOS and Windows. We do not 
recommend undertaking this process without some means 
of reading the screen.
To install outSPOKEN to your hard drive, you must copy 
all files from the root directory of the outSPOKEN 
program disk to a directory on your hard disk. We 
recommend the name C:\OSW for the directory. Also, from 
the DRIVERS directory on your outSPOKEN program disk, 
you will need to copy the driver for your speech 
synthesizer to your new outSPOKEN directory.
Modify the AUTOEXEC.BAT file to include the new 
outSPOKEN directory in the path statement. If you have 
an external synthesizer, add a line at the top of the 
file to run its driver. Internal synthesizers should 
have their drivers run as the last line of the 
AUTOEXEC.BAT file. This loading order prevents 
conflicts with network drivers and other TSRs 
(terminate and stay resident programs). The driver 
command line should be of the following form:
C:\OSW\DRIVER S1
The word "DRIVER" should be replaced with the name of 
your synthesizer driver (without the .COM extension), 
and the directory name OSW should be changed to reflect 
any changes you have made to the name of the directory 
where you have installed outSPOKEN. The argument "S1" 
indicates that the synthesizer is attached to the 
serial port COM1. If you are attaching your synthesizer 
to another COM port, change the number to correspond to 
that port. If your synthesizer is a parallel device, 
replace the letter "S" with the letter "L". The number 
should be that of the LPT port to which it is attached.
The file WIN.INI in your Windows directory needs to 
have the "Load" line modified to include 
"C:\OSW\GUIACCES.EXE". As above, if you have installed 
outSPOKEN to a directory other than OSW, make sure your 
Load line reflects this. The Load line should appear as 
the second line of the [Windows] section of the WIN.INI 
file. If no Load line exists, one should be created. 
The Load line is of the form:
load=C:\OSW\GUIACCES.EXE 
There may be more than one program listed on this line 
(separated by spaces), but we recommend that you put 
outSPOKEN first (right after the equals sign). 
Another file in the Windows directory, the SYSTEM.INI 
file, needs to be modified as well. In the [386 Enh] 
section, the line that reads "keyboard=*vkd" should be 
changed to:
keyboard=C:\OSW\BSIVKD.386
If there is not already a "keyboard=" line, then a line 
of the above form should be added to the [386 Enh] 
section of the SYSTEM.INI file. The drive and path name 
in this statement should reflect any changes you have 
made to the location of outSPOKEN. 
Once you have made these changes, reboot your computer. 
When the synthesizer driver loads, your synthesizer 
should say "Voice ready." You are now ready to launch 
Windows with outSPOKEN.
outSPOKEN does not need to be specified on the Load 
line of the WIN.INI file to be launched automatically 
each time Windows is started. To take advantage of the 
alternatives, however, a degree of familiarity with 
Windows is necessary. The following instructions assume 
some understanding of Windows operation. 
outSPOKEN is a Windows application, and can therefore 
be launched either from Program Manager or from the 
Windows command line. Provided all other modifications 
are made to the files listed above, outSPOKEN 
(GUIACCES.EXE) can be removed from the Load line and 
launched at will. 
To launch outSPOKEN from the Windows command line, 
simply type the following command line at the DOS 
prompt:
WIN \OSW\GUIACCES
If you have installed outSPOKEN to a directory other 
than the default directory, modify the path name in the 
above command line appropriately. When Windows starts, 
outSPOKEN launches, but Program Manager is minimized. 
To open Program Manager, double-click on the Program 
Manager icon or press oENTER .
It is also possible to create a Program Item for 
outSPOKEN in Program Manager. To do this, select the 
New option from the File menu of Program Manager. Press 
oENTER to select the defaulted option of creating a new 
Program Item. The next dialog box is the Program Item 
Properties dialog of Program Manager. The first field 
is the Description field; type "outSPOKEN" and press 
TAB. The next field is the Command Line; type 
"C:\OSW\GUIACCES" and press TAB. If you have made any 
changes to the location of the outSPOKEN directory, be 
sure they are reflected in this command line. The next 
field is Working Directory; type "C:\OSW" unless you 
have installed outSPOKEN to another directory. The next 
field asks for a Shortcut Key. You may assign any 
shortcut key you wish. This will be the command to 
launch outSPOKEN once the Program Item is completed. A 
convenient shortcut key is the letter O with CTRL and 
SHIFT. This is the command to turn outSPOKEN off, so 
assigning it as the key to launch outSPOKEN provides a 
toggle function to this key. It must be noted, however, 
that if outSPOKEN is running when this assignment is 
made, the first press of this key combination turns 
outSPOKEN off. Once the words "Exiting outSPOKEN," are 
heard, pressing the combination again assigns the 
shortcut key. Pressing oENTER exits the Program Item 
Properties dialog, and a third press of the sequence 
re-launches outSPOKEN.
It is also simple to run outSPOKEN from the Run dialog 
of Program Manager. Once Program Manager is running, 
select the Run option from the File menu. Type 
"C:\OSW\GUIACCES" as the command line, and press 
oENTER. If you have installed outSPOKEN to a directory 
other than OSW, make appropriate changes to this 
command line. 
2.4	Launching outSPOKEN
Once outSPOKEN has been installed, it is easy to launch 
it. After installing the program, restart your computer 
by pressing the reset button. As your computer boots 
up, the words "Voice ready" should be spoken by your 
voice synthesizer. This signals the speech driver 
loading into memory. 
We recommend first exploring the outSPOKEN tour, which 
is a word processor document designed for 
experimentation by a beginning outSPOKEN user. To take 
the tour, type the following command line at the "C:\" 
prompt. If the boot process automatically launches 
Windows, the DOS prompt will not appear, and the tour 
will need to be started in a different way (see below).
WIN C:\OSW\OSWTOUR.WRI oENTER
This launches Windows and outSPOKEN is automatically 
loaded. Specifying the outSPOKEN tour file 
(OSWTOUR.WRI) on the command line opens the outSPOKEN 
tour file. Press outSPOKEN's READ REST OF WINDOW 
command (CTRL-KPD 3) after outSPOKEN has been "cleared 
for takeoff" to get started on the tour. outSPOKEN will 
take you from there.
We do not recommend the outSPOKEN tour as an 
alternative to this manual. We offer this 
step at this point to satisfy the curious 
mind, but we strongly encourage reading the 
following chapters before experimenting 
further with Windows and outSPOKEN.
If Windows launches automatically at start-up, there 
will not be an opportunity to type the above command 
line. outSPOKEN is launched automatically. To start the 
outSPOKEN tour from inside Windows, take the following 
steps after hearing the message "outSPOKEN cleared for 
takeoff."
1.	Press the Alt key and the letter "F" at the same 
time (Alt-F) to open the File menu.
2.	Type the letter "R" (without the Alt key) to 
select the "Run" option from the menu.
3.	Type "C:\OSW\OSWTOUR.WRI" to specify the outSPOKEN 
tour file.
4.	Press the oENTER key.
The outSPOKEN tour is now displayed on your screen, and 
pressing CTRL-KPD 3 will get you started. 
In general, Windows can be run from the DOS prompt by 
typing "WIN" then oENTER. outSPOKEN is set up to load 
automatically when Windows is run. The messages 
"outSPOKEN taxiing" and "outSPOKEN cleared for takeoff" 
are spoken after Windows has launched, and while 
outSPOKEN is in the process of loading. Once outSPOKEN 
is "cleared for takeoff," you are ready to use Windows. 
If these voice messages are not heard, or Windows does 
not launch properly, refer to Chapter 6, 
"TROUBLESHOOTING outSPOKEN." 

