= MARY TTS 4.0 beta -- Release Notes =
[http://mary.dfki.de/download/4.0%20beta/openmary-standalone-install-4.0beta.jar MARY TTS 4.0 beta download]

== What's new ==
MARY 4.0 is a major cleanup over previous versions of MARY TTS.

 * 100% Pure Java. All native libraries have been removed from the system. MARY should now run on any platform that has Java 1.5 or newer.
 * Fully open source. All code is now open source under the [http://www.gnu.org/licenses/lgpl-3.0-standalone.html LGPL], including German TTS. Voices are distributed under Creative Commons or BSD licenses.
 * New languages. We have added Turkish and Telugu synthesis for now, and have made it easy to add more languages in the future.

MARY now comes with a toolkit for people who want to add support for new languages or build their own voices. There is detailed documentation for

 * [wiki:NewLanguageSupport creating initial support for a new language];
 * [wiki:VoiceImportToolsTutorial recording and building a unit selection voice]; and
 * [wiki:HMMVoiceCreationMary4.0 creating an HMM-based voice] from the same recordings.

More details on individual issues addressed can be seen in the [http://mary.opendfki.de/query?status=closed&group=resolution&milestone=4.0+beta list of tickets associated with this release].

== Tested environments ==
The MARY client and server code was tested on:

 * Mac OS X (Intel) 10.5.8 with java 1.6.0_07
 * Ubuntu Linux 8.10 and 9.04 with sun java 1.5, 1.6, and openjdk-6
 * Windows XP and Vista

The web interface at http://localhost:59125 should work with any recent browser that supports AJAX. We have obtained best results with:

 * Firefox 3.5 with built-in audio support
 * Firefox 3.0, Internet Explorer 6 and 7, Safari 4, with Quicktime plugin

== Known issues ==
 * On Ubuntu Linux with sun java 1.5 and 1.6, we observed a problem with audio playback in the MARY client: the final section is cut off. With openjdk-6, it works ok.
 * On Ubuntu Linux 8.10 with the builtin Firefox 3.0, the audio plugin doesn't work properly.
 * Web interface in the browser Chrome suboptimal: Chrome does not seem to handle the HTML 5 <audio> tag correctly. It claims it can handle it, but then doesn't play audio. Click on "Save audio file" to get the raw audio data.

== Bug reports ==
This is beta software. It is not yet ready for production use. You are likely to find problems, and we would appreciate if you tell us about it.

If you think you have identified a bug, proceed as follows:

 1. Check in the [http://mary.opendfki.de/query?group=status&milestone=4.0 list of known bugs] whether the bug has been reported already;
 1. If you cannot find it, create a [http://mary.opendfki.de/newticket new ticket] containing the following information:
   * operating system and java version used;
   * what to do to reproduce the error;
   * expected behaviour;
   * detailed log files, i.e. an excerpt of MARY TTS/log/server.log containing the error episode.
 1. Discuss the problem on the [http://www.dfki.de/mailman/listinfo/mary-users MARY user mailing list].

== Contributions ==
People interested in adding support for a language can get in touch, e.g. via the [http://www.dfki.de/mailman/listinfo/mary-dev MARY developers mailing list].