1
2This is Epos, a freely distributable language independent Text-to-Speech
3system. See doc/COPYING for distribution conditions.
4
5------------------------------------------------------------------------
6
7Compiling and installation on a UNIX machine:
8
9 1. ./configure
10 2. make
11 3. make install   (with sufficient rights to install cfg files under /usr/local/share/epos)
12 4. install speech segment inventories (see cfg/inv/README for an explanation;
13	untar them starting from /usr/local/share/epos/inv)
14
15Running on a UNIX machine:
16 eposd       starts a speech daemon
17 say-epos    controls this daemon, e.g. "say-epos 'Some text'" means "tell eposd to
18	     say 'some text'".
19
20-------------------------------------------------------------------------
21
22Compiling with Visual C++ and installation on a Windows NT (Windows 2000 etc.) machine:
23
24 1. cd arch\win
25 2. copy cpconv2.exe into arch\win if you require the conversion of
26	configuration files into code page 1250 (this is optional)
27 3. .\configure.bat
28 4. cd ..\..\src
29 5. run VC and open the workspace file epos.dsw
30 6. build all the projects - at least instserv, eposd and say-epos
31 7. install speech segment inventories (see cfg/inv/README) if required
32	(copy them to the cfg\\inv directory and untar them there)
33 8. run instserv.exe (it should compile into the same directory as eposd.exe,
34    else it won't find eposd.exe) with sufficient rights to install Epos
35    as a Text-to-Speech service and to write a pointer to its configuration
36    to the registry
37
38Then try to run "say-epos.exe some text" with sufficient privileges to hear Epos speak.
39
40----------------------------------------------------------------
41
42The default configuration speaks Czech using the local sound card and
43the public TTSCP server at epos.ure.cas.cz. If you don't have a sound
44card, you might wish to try "say-epos -w 'Some text'" to create said.wav
45which is an MS Windows-style .wav file. If you are not connected to
46the Internet, or epos.ure.cas.cz is unreachable or misconfigured
47Epos will revert to a low quality voice distributed with Epos for this
48purpose.  (In some versions of Epos the default voice is supposed
49to be installed locally.  Be creative.  Use "say-epos -l" to find out
50the order of the voices.  Use "say-epos --voice xxxxxxx 'Some text'" to
51use a specific voice.)
52
53System requirements:
54
55 Any decent C++ compiler, for example gcc 2.8 or later.
56	Good choices also include MS Visual C++, Watcom C++; otherwise
57	"decent" means "recent".
58 (If using the GNU assembler, gas version 2.9 or newer is recommended.)
59
60More info:
61
62 1. read doc/*.sgml (or, in the compiled form: epos.dvi or epos.html or epos.txt)
63 2. there are other relevant files under "doc"
64 3. browse http://epos.ure.cas.cz/ (mostly identical to (1))
65 4. have a look at the files under cfg (or /usr/local/share/epos)
66 5. read the source under src
67(The last two steps are optional.)
68
69Getting help:
70
71 0. The order of the following steps is important.
72 1. Download a recent version.
73 2. Get more info as outlined above.
74 3. Mail to epos@speech.cz
75    Mention the version you're running or trying to run
76    (to be found in common.h or by "eposd -v") and describe your
77    problems. If your mail bounces, you might try geo@cuni.cz instead.
78
79Bug reports:
80
81	If you think you found a technical bug, you can send it
82	directly to epos-dev@speech.cz.  This is a developer
83	list.  The list language is English. Consider subscribing
84	to the list first so that you miss no answers if somebody
85	forgets to CC you.  Again, be sure to mention the version
86	you are trying to run.
87