This is the source code repository for the multilingual open-source MARY text-to-speech platform (MaryTTS). MaryTTS is a client-server system written in pure Java, so it runs on many platforms.
For a downloadable package ready for use, see the releases page.
For documentation on using MaryTTS from various angles, see the wiki.
Older documentation can also be found at http://mary.dfki.de and https://mary.opendfki.de.
This README is part of the the MaryTTS source code repository. It contains information about compiling and developing the MaryTTS sources.
The code comes under the Lesser General Public License LGPL version 3 -- see LICENSE.md for details.
Run ./gradlew run
(or gradlew.bat run
on Windows) to start a MaryTTS server.
Then access it at http://localhost:59125 using your web browser.
Run ./gradlew runInstallerGui
to start an installer GUI to download and install more voices.
A running MaryTTS server needs to be restarted before the new voices can be used.
Run ./gradlew build
.
This will compile and test all modules, and create the output for each under build/
.
Note that previously, MaryTTS v5.x was built with Maven. Please refer to the 5.x branch.
Run ./gradlew distZip
or ./gradlew distTar
to build a distribution package under build/distributions
.
You can also "install" an unpacked distribution directly into build/install
by running ./gradlew installDist
.
The distribution contains all the files required to run a standalone MaryTTS server instance, or to download and install more voices.
The scripts to run the server or installer GUI can be found inside the distribution in the bin/
directory.
The easiest way to use MaryTTS in your own Java projects is to declare a dependency on a relevant MaryTTS artifact, such as the default US English HSMM voice:
Add to your pom.xml
:
<repositories>
<repository>
<url>https://jcenter.bintray.com</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>de.dfki.mary</groupId>
<artifactId>voice-cmu-slt-hsmm</artifactId>
<version>5.2</version>
</dependency>
</dependencies>
Add to your build.gradle
:
repositories {
jcenter()
}
dependencies {
compile group: 'de.dfki.mary', name: 'voice-cmu-slt-hsmm', version: '5.2'
}
Text to wav basic examples are proposed in this repository
- Maven: https://github.com/marytts/marytts-txt2wav/tree/maven
- Gradle: https://github.com/marytts/marytts-txt2wav/tree/gradle
If you want to use MaryTTS for other programming languages (like python for example), you need to achieve 3 steps
- compiling marytts
- starting the server
- query synthesis on the server
Synthesizing speech, using the server, is pretty easy. You need to generate proper HTTP queries and deal with the associated HTTP responses. Examples are proposed :
- python 3: https://github.com/marytts/marytts-txt2wav/tree/python
- shell: https://github.com/marytts/marytts-txt2wav/tree/sh
The recommended workflow for making contributions to the MaryTTS source code is to follow the GitHub model:
-
fork the MaryTTS repository into your own profile on GitHub, by navigating to https://github.com/marytts/marytts and clicking "fork" (of course you need a GitHub account);
-
use the
git clone
,commit
, andpush
commands to make modifications on your own marytts repository; in this process, make sure togit pull upstream master
regularly to stay in sync with latest developments on the master repo; -
when you think a reusable contribution is ready, open a "pull request" on GitHub to allow for easy merging into the master repository.
Have a look at the GitHub documentation for further details.
Wiki pages are available to help you to configure your IDE to develop MaryTTS. The following IDEs have been tested and documented:
- IntelliJ IDEA
- Eclipse: https://github.com/marytts/marytts/wiki/Eclipse