MARY TTS -- an open-source, multilingual text-to-speech synthesis system written in pure java
Java XSLT HTML JavaScript Shell Groovy
Latest commit 4ad6612 Feb 22, 2017 @psibre psibre committed on GitHub Merge pull request #696 from psibre/drop-lexicon-compile-subprojects
Drop lexicon compile subprojects
Failed to load latest commit information.
doc drop redundant README May 10, 2016
download update url pattern for github release assets Sep 15, 2016
gradle/wrapper upgrade gradle to v3.2 Nov 15, 2016
lib externalize Jampack artifacts in project-local repo Oct 11, 2015
marytts-assembly prepare for v6.0 Sep 16, 2016
marytts-builder prepare for v6.0 Sep 16, 2016
marytts-client prepare for v6.0 Sep 16, 2016
marytts-common make version property available to test run with maven Oct 26, 2016
marytts-languages drop lexicon submodules Feb 22, 2017
marytts-redstart prepare for v6.0 Sep 16, 2016
marytts-runtime test TTS instead of expecting failure Oct 20, 2016
marytts-signalproc drop JUnit from marytts-common, update downstream subprojects' test d… Oct 19, 2016
marytts-transcription prepare for v6.0 Sep 16, 2016
src drop redundant entries from Russian userdict Feb 22, 2017
tmp svn cosmetics Jun 15, 2010
voice-cmu-slt-hsmm move module test back into marytts-runtime Oct 20, 2016
.gitattributes add .gitattributes to normalize line endings Dec 18, 2014
.gitignore ignore IDEA metadata Sep 16, 2016
.travis.yml revert build environment customizations Feb 22, 2017 purge freetts references in documentation, licenses May 28, 2015 update README Nov 15, 2016
applicationLogic.gradle include license in distribution Nov 16, 2016
build.gradle fix resolution errors in assemble Feb 22, 2017
buildLogic.gradle fix resolution errors in assemble Feb 22, 2017
dependencies.gradle activate build logic for marytts-lang-* Oct 19, 2016
eclipse-code-style.xml add Java formatter profile from Eclipse Luna Dec 18, 2014
gpl-3.0.txt And added the license text itself. Jan 23, 2009
gradlew upgrade gradle to v3.2 Nov 15, 2016
gradlew.bat init gradle wrapper Sep 16, 2016
lgpl-3.0.txt And added the license text itself. Jan 23, 2009
pom.xml prepare for v6.0 Sep 16, 2016
settings.gradle drop lexicon subprojects Feb 22, 2017

Build Status


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 and

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 for details.

Running MaryTTS

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.

Downloading and installing voices

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.

Building MaryTTS

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.

Packaging MaryTTS

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.

Using MaryTTS in your own Java projects

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:




Add to your build.gradle:

repositories {

dependencies {
  compile group: 'de.dfki.mary', name: 'voice-cmu-slt-hsmm', version: '5.2'

Synthesizing speech

Text to wav basic examples are proposed in this repository

Using MaryTTS for other programming languages

If you want to use MaryTTS for other programming languages (like python for example), you need to achieve 3 steps

  1. compiling marytts
  2. starting the server
  3. query synthesis on the server

Synthesize speech using 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 :


The recommended workflow for making contributions to the MaryTTS source code is to follow the GitHub model:

  1. fork the MaryTTS repository into your own profile on GitHub, by navigating to and clicking "fork" (of course you need a GitHub account);

  2. use the git clone, commit, and push commands to make modifications on your own marytts repository; in this process, make sure to git pull upstream master regularly to stay in sync with latest developments on the master repo;

  3. 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.

IDE configuration

Wiki pages are available to help you to configure your IDE to develop MaryTTS. The following IDEs have been tested and documented: