Il s'agit du référentiel de code source de la plateforme de synthèse vocale multilingue open source MARY (MaryTTS). MaryTTS est un système client-serveur écrit en Java pur, il fonctionne donc sur de nombreuses plates-formes.
Pour un package téléchargeable prêt à l’emploi, consultez la page des versions.
Une documentation plus ancienne peut également être trouvée sur https://github.com/marytts/marytts-wiki, http://mary.dfki.de et https://mary.opendfki.de.
Ce README fait partie du référentiel de code source MaryTTS. Il contient des informations sur la compilation et le développement des sources MaryTTS.
Le code relève de la licence publique générale limitée LGPL version 3 – voir LICENSE.md pour plus de détails.
Exécutez ./gradlew run
(ou gradlew.bat run
sous Windows) pour démarrer un serveur MaryTTS. Accédez-y ensuite à http://localhost:59125 à l'aide de votre navigateur Web.
Si vous souhaitez démarrer un MaryTTS sur une adresse et un port différents, vous pouvez utiliser les options suivantes :
./gradlew run -Dsocket.port=5920 -Dsocket.addr=0.0.0.0 --info
où 5920 est le nouveau port et 0.0.0.0 la nouvelle adresse. Dans le cas où l'adresse est 0.0.0.0, toutes les interfaces seront écoutées.
En utilisant l'option --info
, vous définissez le logger de gradle
AND MaryTTS au niveau INFO. En utilisant --debug
, vous définissez le niveau sur DEBUG.
Il est également possible de définir le niveau de journalisation MaryTTS sur INFO
ou DEBUG
en définissant la variable système log4j.logger.marytts
.
Exécutez ./gradlew runInstallerGui
pour démarrer une interface graphique d'installation afin de télécharger et d'installer plus de voix. Un serveur MaryTTS en cours d'exécution doit être redémarré avant que les nouvelles voix puissent être utilisées.
Exécutez ./gradlew build
. Cela compilera et testera tous les modules, et créera la sortie pour chacun sous build/
.
Notez qu'auparavant, MaryTTS v5.x était construit avec Maven. Veuillez vous référer à la branche 5.x .
Exécutez ./gradlew distZip
ou ./gradlew distTar
pour créer un package de distribution sous build/distributions
. Vous pouvez également "installer" une distribution décompressée directement dans build/install
en exécutant ./gradlew installDist
.
La distribution contient tous les fichiers requis pour exécuter une instance de serveur MaryTTS autonome ou pour télécharger et installer plus de voix. Les scripts pour exécuter l'interface graphique du serveur ou du programme d'installation se trouvent dans la distribution dans le répertoire bin/
.
Le moyen le plus simple d'utiliser MaryTTS dans vos propres projets Java est de déclarer une dépendance sur un artefact MaryTTS pertinent, tel que la voix HSMM anglais américain par défaut :
Ajoutez à votre pom.xml
:
< 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 >
Ajoutez à votre build.gradle
:
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 '
}
Des exemples de base de texte en wav sont proposés dans ce référentiel
Si vous souhaitez utiliser MaryTTS pour d'autres langages de programmation (comme python par exemple), vous devez réaliser 3 étapes
Synthétiser la parole, à l'aide du serveur, est assez simple. Vous devez générer des requêtes HTTP appropriées et gérer les réponses HTTP associées. Des exemples sont proposés :
Un exemple de définition du serveur Marytts en tant que service est proposé ici.
Vous pouvez étendre les dictionnaires en ajoutant un dictionnaire utilisateur. La documentation expliquant comment procéder est ici.
Le flux de travail recommandé pour apporter des contributions au code source de MaryTTS consiste à suivre le modèle GitHub :
insérez le référentiel MaryTTS dans votre propre profil sur GitHub, en accédant à https://github.com/marytts/marytts et en cliquant sur « fork » (bien sûr, vous avez besoin d'un compte GitHub) ;
utilisez les commandes git clone
, commit
et push
pour apporter des modifications à votre propre référentiel marytts ; dans ce processus, assurez-vous d'utiliser régulièrement git pull upstream master
pour rester synchronisé avec les derniers développements sur le dépôt principal ;
lorsque vous pensez qu'une contribution réutilisable est prête, ouvrez une « pull request » sur GitHub pour permettre une fusion facile dans le référentiel maître.
Jetez un œil à la documentation GitHub pour plus de détails.
Des pages wiki sont disponibles pour vous aider à configurer votre IDE pour développer MaryTTS. Les IDE suivants ont été testés et documentés :