= Welcome to the !OpenMary development page =
This is the home of the source code of the !OpenMary text-to-speech synthesis system.

For an introduction to MARY, online demos, and for downloading an installer for the MARY system, go to the  [http://mary.dfki.de main MARY page].

On these development pages, you can [source: browse the source code], and [http://mary.opendfki.de/newticket submit bug reports] (but look at the [report:3 existing bug reports] first!).

== What's new ==
[wiki:4.0beta 4.0 beta Release Notes]

== SVN access to the repository ==
You can check out the latest development source code from the SVN trunk, using the following command:

{{{
   svn checkout https://mary.opendfki.de/repos/trunk openmary
}}}
The source code of released versions can be found below [source:tags/]. For example, to check out the source code of the "4.0 beta" release, do this:

{{{
   svn checkout https://mary.opendfki.de/repos/tags/4.0beta openmary-4.0beta
}}}
== Bug reports ==
If you think you have identified a bug, we would like to hear about it. For a meaningful bug report, 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].

== Mailing List ==
If you use the MARY system, you can subscribe to the [http://dfki.de/mailman/listinfo/mary-users mary-users mailing list]. Topics that should be discussed here include:

 * How to use the MARY system: run the server, start the client, save audio, run MARY in standalone mode, etc.
 * Suggestions for improvement, bug reports, feature requests (no guarantees of course that anyone has time to do it).

The [http://www.dfki.de/mailman/listinfo/mary-dev MARY developers mailing list] is for discussions around the MARY TTS source code:

 * Improvements of the core MARY code;
 * issues around attempts to build new language components and voices;
 * issues arising when integrating MARY TTS into other code.

== Wiki documentation ==
 * [wiki:FrequentlyAskedQuestions Frequently Asked Questions]
 * Documentation for adding support for a new language and voice:
   * [wiki:NewLanguageSupport New language support]
   * [wiki:VoiceImportToolsTutorial Building a New Voice for MARY using Voice Import Components]
   * [http://mary.opendfki.de/wiki/HMMVoiceCreationMary4.0 creating an HMM-based voice]

Guidelines for code development:

 * [wiki:ExceptionGuidelines Guidelines to the use of Exceptions in MARY code]

== Contributions ==
People interested in adding support for a language in MARY TTS can contact Marc Schröder (schroed at dfki.de). We can discuss whether you want to do your development on your own servers or in a branch on the MARY SVN repository. Once it is sufficiently mature, your contribution could be merged into the trunk and become part of a future MARY TTS release. 

Any pronunciation corrections are welcome on the PronunciationCorrections page.

== Trac ==
This development environment is built using [wiki:TracGuide Trac].