Dies ist das Quellcode-Repository für die mehrsprachige Open-Source-Text-to-Speech-Plattform MARY (MaryTTS). MaryTTS ist ein Client-Server-System, das in reinem Java geschrieben ist und daher auf vielen Plattformen läuft.
Ein herunterladbares, einsatzbereites Paket finden Sie auf der Seite „Releases“.
Ältere Dokumentationen finden Sie auch unter https://github.com/marytts/marytts-wiki, http://mary.dfki.de und https://mary.opendfki.de.
Diese README-Datei ist Teil des MaryTTS-Quellcode-Repositorys. Es enthält Informationen zum Kompilieren und Entwickeln der MaryTTS-Quellen.
Der Code unterliegt der Lesser General Public License LGPL Version 3 – Einzelheiten finden Sie unter LICENSE.md.
Führen Sie ./gradlew run
(oder gradlew.bat run
unter Windows) aus, um einen MaryTTS-Server zu starten. Greifen Sie dann mit Ihrem Webbrowser unter http://localhost:59125 darauf zu.
Wenn Sie ein MaryTTS auf einer anderen Adresse und einem anderen Port starten möchten, können Sie folgende Möglichkeiten nutzen:
./gradlew run -Dsocket.port=5920 -Dsocket.addr=0.0.0.0 --info
Dabei ist 5920 der neue Port und 0.0.0.0 die neue Adresse. Wenn die Adresse 0.0.0.0 ist, werden alle Schnittstellen überwacht.
Mit der Option --info
legen Sie den Logger von gradle
AND MaryTTS auf der Ebene INFO fest. Durch die Verwendung --debug
legen Sie die Ebene auf DEBUG fest.
Es ist auch möglich, die MaryTTS-Loggerebene auf INFO
oder DEBUG
zu setzen, indem Sie die Systemvariable log4j.logger.marytts
definieren.
Führen Sie ./gradlew runInstallerGui
aus, um eine Installations-GUI zu starten und weitere Stimmen herunterzuladen und zu installieren. Ein laufender MaryTTS-Server muss neu gestartet werden, bevor die neuen Stimmen verwendet werden können.
Führen Sie ./gradlew build
aus. Dadurch werden alle Module kompiliert und getestet und die Ausgabe für jedes unter build/
erstellt.
Beachten Sie, dass MaryTTS v5.x zuvor mit Maven erstellt wurde. Bitte beachten Sie den 5.x-Zweig .
Führen Sie ./gradlew distZip
oder ./gradlew distTar
aus, um ein Distributionspaket unter build/distributions
zu erstellen. Sie können eine entpackte Distribution auch direkt in build/install
„installieren“, indem Sie ./gradlew installDist
ausführen.
Die Distribution enthält alle Dateien, die zum Ausführen einer eigenständigen MaryTTS-Serverinstanz oder zum Herunterladen und Installieren weiterer Stimmen erforderlich sind. Die Skripte zum Ausführen der Server- oder Installations-GUI finden Sie in der Distribution im Verzeichnis bin/
.
Der einfachste Weg, MaryTTS in Ihren eigenen Java-Projekten zu verwenden, besteht darin, eine Abhängigkeit von einem relevanten MaryTTS-Artefakt zu deklarieren, z. B. der Standard-US-Englisch-HSMM-Stimme:
Fügen Sie Ihrer pom.xml
Folgendes hinzu:
< repositories >
< repository >
< url >https://raw.githubusercontent.com/DFKI-MLT/Maven-Repository/main</ url >
</ repository >
</ repositories >
< dependencies >
< dependency >
< groupId >de.dfki.mary</ groupId >
< artifactId >voice-cmu-slt-hsmm</ artifactId >
< version >5.2.1</ version >
</ dependency >
</ dependencies >
Fügen Sie zu Ihrem build.gradle
Folgendes hinzu:
repositories {
mavenCentral()
exclusiveContent {
forRepository {
maven {
url ' https://raw.githubusercontent.com/DFKI-MLT/Maven-Repository/main '
}
}
filter {
includeGroup ' de.dfki.lt.jtok '
}
}
}
dependencies {
implementation group : ' de.dfki.mary ' , name : ' voice-cmu-slt-hsmm ' , version : ' 5.2.1 '
}
In diesem Repository werden grundlegende Beispiele für die Umwandlung von Text in WAV vorgeschlagen
Wenn Sie MaryTTS für andere Programmiersprachen (wie beispielsweise Python) verwenden möchten, müssen Sie drei Schritte ausführen
Die Sprachsynthese mithilfe des Servers ist ziemlich einfach. Sie müssen ordnungsgemäße HTTP-Abfragen generieren und die zugehörigen HTTP-Antworten verarbeiten. Beispiele werden vorgeschlagen:
Hier wird ein Beispiel für die Definition des Marytts-Servers als Dienst vorgeschlagen.
Sie können die Wörterbücher erweitern, indem Sie ein Benutzerwörterbuch hinzufügen. Die Dokumentation dazu finden Sie hier.
Der empfohlene Arbeitsablauf für Beiträge zum MaryTTS-Quellcode besteht darin, dem GitHub-Modell zu folgen:
Verzweigen Sie das MaryTTS-Repository in Ihr eigenes Profil auf GitHub, indem Sie zu https://github.com/marytts/marytts navigieren und auf „Fork“ klicken (natürlich benötigen Sie ein GitHub-Konto);
Verwenden Sie die Befehle git clone
, commit
“ und push
, um Änderungen an Ihrem eigenen Marytts-Repository vorzunehmen. Stellen Sie in diesem Prozess sicher, dass git pull upstream master
regelmäßig ausgeführt wird, um mit den neuesten Entwicklungen im Master-Repo auf dem Laufenden zu bleiben.
Wenn Sie glauben, dass ein wiederverwendbarer Beitrag fertig ist, öffnen Sie eine „Pull-Anfrage“ auf GitHub, um eine einfache Zusammenführung in das Master-Repository zu ermöglichen.
Weitere Details finden Sie in der GitHub-Dokumentation.
Es stehen Wiki-Seiten zur Verfügung, die Ihnen bei der Konfiguration Ihrer IDE für die Entwicklung von MaryTTS helfen. Die folgenden IDEs wurden getestet und dokumentiert: