= 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!).

== Bug reports ==
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].

== 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 ==
Here are some entry points to get us started:

 * [wiki:FrequentlyAskedQuestions Frequently Asked Questions]
 * [wiki:VoiceImportToolsTutorial Building a New Voice for MARY using Voice Import Components]

Guidelines for code development:

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

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

{{{
   svn checkout https://mary.opendfki.de/repos/trunk openmary
}}}
== Want to help? ==
As all open source projects, !OpenMary can only thrive with contributions from the community.

Any pronunciation corrections are welcome on the PronunciationCorrections page.

If you have a suggestion what you would like to implement, it might be a good idea to discuss it on the [http://dfki.de/mailman/listinfo/mary-users mary-users list], and/or to [/newticket submit a ticket].

If you would like to help but would need inspiration what you could do, do take a look at the [report:3 active tickets], or more specifically at the section [http://mary.opendfki.de/milestone/Volunteers%20wanted%21 Volunteers wanted]!

Contact Marc Schröder (schroed at dfki.de) if you want to get write access to the repository.

[wiki:4.0beta 4.0 beta Release Notes]

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