source: multimedia/audioutils/freetts.xml@ 208d44a9

10.0 10.1 11.0 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 208d44a9 was 208d44a9, checked in by Randy McMurchy <randy@…>, 15 years ago

Added Sharutils (for the uudecode program) to the FreeTTS required dependencies, thanks to Chris Staub for the report

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6369 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY freetts-download-http "http://prdownloads.sourceforge.net/freetts/freetts-&freetts-version;-src.zip">
8 <!ENTITY freetts-download-ftp " ">
9 <!ENTITY freetts-md5sum "f3e3ceae5b8cb5e175b50931f2e350e8">
10 <!ENTITY freetts-size "14.1 MB">
11 <!ENTITY freetts-buildsize "112 MB">
12 <!ENTITY freetts-time "0.4 SBU">
13
14 <!ENTITY freetts-testsuite-download "http://prdownloads.sourceforge.net/freetts/freetts-&freetts-version;-tst.zip">
15 <!ENTITY freetts-testsuite-md5sum "8e461701ee94b3942cc37783f6de4128">
16 <!ENTITY freetts-testsuite-size "3.9 MB">
17
18]>
19
20<sect1 id="freetts" xreflabel="FreeTTS-&freetts-version;">
21 <?dbhtml filename="freetts.html"?>
22
23 <sect1info>
24 <othername>$LastChangedBy$</othername>
25 <date>$Date$</date>
26 </sect1info>
27
28 <title>FreeTTS-&freetts-version;</title>
29
30 <indexterm zone="freetts">
31 <primary sortas="a-FreeTTS">FreeTTS</primary>
32 </indexterm>
33
34 <sect2 role="package">
35 <title>Introduction to FreeTTS</title>
36
37 <para>The <application>FreeTTS</application> package contains a speech
38 synthesis system written entirely in the <application>Java</application>
39 programming language. It is based upon
40 <ulink url="http://www.cmuflite.org/">Flite</ulink>: a small run-time
41 speech synthesis engine developed at Carnegie Mellon University.
42 <application>Flite</application> is derived from the
43 <ulink url="http://www.cstr.ed.ac.uk/projects/festival/">Festival</ulink>
44 Speech Synthesis System from the University of Edinburgh and the
45 <ulink url ="http://festvox.org/">FestVox</ulink> project from Carnegie
46 Mellon University. The <application>FreeTTS</application> package is used
47 to convert text to audible speech through the system audio hardware.</para>
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>Download (HTTP): <ulink url="&freetts-download-http;"/></para>
53 </listitem>
54 <listitem>
55 <para>Download (FTP): <ulink url="&freetts-download-ftp;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download MD5 sum: &freetts-md5sum;</para>
59 </listitem>
60 <listitem>
61 <para>Download size: &freetts-size;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated disk space required: &freetts-buildsize;</para>
65 </listitem>
66 <listitem>
67 <para>Estimated build time: &freetts-time;</para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>Test suite: <ulink url="&freetts-testsuite-download;"/></para>
75 </listitem>
76 <listitem>
77 <para>Download MD5 sum: &freetts-testsuite-md5sum;</para>
78 </listitem>
79 <listitem>
80 <para>Download size: &freetts-testsuite-size;</para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">FreeTTS Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required"><xref linkend="apache-ant"/> (and
88 <ulink url="http://www.junit.org/">JUnit</ulink>
89 to run the test suite),
90 <xref linkend="unzip"/>,
91 <ulink url="http://www.gnu.org/software/sharutils/">Sharutils</ulink>
92 (for the <command>uudecode</command> program),
93 and working audio hardware/software.</para>
94
95 <para condition="html" role="usernotes">User Notes:
96 <ulink url="&blfs-wiki;/freetts"/></para>
97
98 </sect2>
99
100 <sect2 role="installation">
101 <title>Installation of FreeTTS</title>
102
103 <para>The <application>FreeTTS</application> package is distributed in
104 ZIP format and the <command>unzip</command> command will default to
105 creating an unused source directory. Additionally,
106 unzipping the test suite file will prompt for questions
107 about overwriting existing files. Use the following commands to
108 <command>unzip</command> the source files:</para>
109
110<screen><userinput>unzip -q freetts-&freetts-version;-src.zip -x META-INF/* &amp;&amp;
111unzip -q freetts-&freetts-version;-tst.zip \
112 -x {META-INF/*,freetts-&freetts-version;/{acknowledgments.txt,license.terms}}</userinput></screen>
113
114 <tip>
115 <para>The <command>sh jsapi.sh</command> command below installs the Java
116 Speech API components into the <application>FreeTTS</application> source
117 tree. You will be required to view, and then accept (by entering a
118 <keycap>y</keycap> keypress), a license agreement before the installation
119 will continue. If you are scripting (automating) the build, you'll need
120 to account for this. There is information about automating build commands
121 in the <xref linkend="automating-builds"/> section of Chapter 2. Towards
122 the end of this section, specific information for automating this type of
123 installation is discussed.</para>
124 </tip>
125
126 <para>Install <application>FreeTTS</application> by running the following
127 commands:</para>
128
129<screen><userinput>cd lib &amp;&amp;
130sh jsapi.sh &amp;&amp;
131cd .. &amp;&amp;
132ant</userinput></screen>
133
134 <para>To test the results, issue:</para>
135
136<screen><userinput>ant junit &amp;&amp;
137sh regression.sh</userinput></screen>
138
139 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
140
141<screen role="root"><userinput>install -v -m755 -d /opt/freetts-&freetts-version;/{lib,docs/{audio,images}} &amp;&amp;
142install -v -m644 lib/*.jar /opt/freetts-&freetts-version;/lib &amp;&amp;
143install -v -m644 *.txt RELEASE_NOTES license.terms \
144 docs/*.{pdf,html,txt,sx{w,d}} \
145 /opt/freetts-&freetts-version;/docs &amp;&amp;
146install -v -m644 docs/audio/* /opt/freetts-&freetts-version;/docs/audio &amp;&amp;
147install -v -m644 docs/images/* /opt/freetts-&freetts-version;/docs/images &amp;&amp;
148cp -v -R javadoc /opt/freetts-&freetts-version; &amp;&amp;
149ln -v -s freetts-&freetts-version; /opt/freetts</userinput></screen>
150
151 <para>Optionally, install any or all of the additional
152 <application>FreeTTS</application> components using the following
153 commands as the <systemitem class="username">root</systemitem> user
154 (see the Command Explanations section for details):</para>
155
156<screen role="root"><userinput>cp -v -R bin /opt/freetts-&freetts-version; &amp;&amp;
157install -v -m644 speech.properties /opt/jdk/jdk/jre/lib &amp;&amp;
158cp -v -R tools /opt/freetts-&freetts-version; &amp;&amp;
159cp -v -R mbrola /opt/freetts-&freetts-version; &amp;&amp;
160cp -v -R demo /opt/freetts-&freetts-version;</userinput></screen>
161
162 </sect2>
163
164 <sect2 role="commands">
165 <title>Command Explanations</title>
166
167 <para><command>sh jsapi.sh</command>: This command installs the
168 <application>Java Speech API</application> components into the
169 <application>FreeTTS</application> source tree.</para>
170
171 <para><command>ant</command>: <application>FreeTTS</application> uses the
172 <application>Apache Ant</application> build system instead of the GNU
173 <application>autotools</application>. This commands builds everything,
174 including the class libraries, tools and demos.</para>
175
176 <para><command>cp -v -R bin ...</command>;
177 <command>install -v -m644 speech.properties</command>: These two commands
178 install the demonstration programs. Optionally copy the
179 <filename>speech.properties</filename> file to
180 <filename>~/speech.properties</filename> if you don't want to make it
181 available system-wide.</para>
182
183 <para><command>cp -v -R tools ...</command>: This installs the voice data
184 import utilities. See the <filename>README.html</filename> files in the
185 <filename class='directory'>tools/</filename> subdirectories for
186 information and instructions about using the tools.</para>
187
188 <para><command>cp -v -R mbrola ...</command>: This installs the
189 <filename class='libraryfile'>mbrola.jar</filename> file, required if you
190 use the <ulink
191 url="http://freetts.sourceforge.net/mbrola/README.html">MBROLA</ulink>
192 voices.</para>
193
194 <para><command>cp -v -R demo ...</command>: This installs the sources
195 and documentation for the demonstration programs.</para>
196
197 <para>For additional information and documentation about the
198 <application>FreeTTS</application> project, visit the main web page at
199 <ulink url="http://freetts.sourceforge.net"/>.</para>
200
201 </sect2>
202
203 <sect2 role="testing">
204 <title>Testing the Installation</title>
205
206 <para>Test the installation using the following command:</para>
207
208<screen><userinput>java -jar /opt/freetts/lib/freetts.jar \
209 -text "This is a test of the FreeTTS speech synthesis system"</userinput></screen>
210
211 <para>Depending on the setup of your audio drivers and software, you
212 may have to add the <option>-streaming</option> switch to the command
213 as shown below:</para>
214
215<screen><userinput>java -jar /opt/freetts/lib/freetts.jar -streaming \
216 -text "This is a test of the FreeTTS speech synthesis system"</userinput></screen>
217
218 </sect2>
219
220 <sect2 role="content">
221 <title>Contents</title>
222
223 <segmentedlist>
224 <segtitle>Installed Programs</segtitle>
225 <segtitle>Installed Libraries</segtitle>
226 <segtitle>Installed Directory</segtitle>
227
228 <seglistitem>
229 <seg>None</seg>
230 <seg>/opt/freetts-&freetts-version;/lib/*.jar</seg>
231 <seg>/opt/freetts-&freetts-version;</seg>
232 </seglistitem>
233 </segmentedlist>
234
235 <variablelist>
236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
237 <?dbfo list-presentation="list"?>
238 <?dbhtml list-presentation="table"?>
239
240 <varlistentry>
241 <term><filename class='libraryfile'>*.jar </filename></term>
242 <listitem>
243 <para>contains the class libraries which make up the
244 <application>FreeTTS</application> speech synthesis system.</para>
245 </listitem>
246 </varlistentry>
247 </variablelist>
248
249 </sect2>
250
251</sect1>
Note: See TracBrowser for help on using the repository browser.