From 0166fdaee6a40fd9558208fdc33c2a876e91b9bc Mon Sep 17 00:00:00 2001 From: lolodomo Date: Sun, 23 Jan 2022 22:50:50 +0100 Subject: [PATCH] [TTS services] Enhance doc to explain how to setup default voice (#12099) Signed-off-by: Laurent Garnier --- bundles/org.openhab.voice.googletts/README.md | 11 +++++++++-- bundles/org.openhab.voice.mactts/README.md | 16 ++++++++++++++++ bundles/org.openhab.voice.marytts/README.md | 16 ++++++++++++++++ bundles/org.openhab.voice.picotts/README.md | 16 ++++++++++++++++ bundles/org.openhab.voice.pollytts/README.md | 16 ++++++++++++++++ bundles/org.openhab.voice.voicerss/README.md | 11 +++++++++-- 6 files changed, 82 insertions(+), 4 deletions(-) diff --git a/bundles/org.openhab.voice.googletts/README.md b/bundles/org.openhab.voice.googletts/README.md index a8ad7a634..80aa66fe6 100644 --- a/bundles/org.openhab.voice.googletts/README.md +++ b/bundles/org.openhab.voice.googletts/README.md @@ -64,11 +64,18 @@ org.openhab.voice.googletts:speakingRate=1 org.openhab.voice.googletts:purgeCache=false ``` -## Voice Configuration +### Default Text-to-Speech and Voice Configuration -Using your favorite configuration UI: +You can setup your preferred default Text-to-Speech and default voice in the UI: * Go to **Settings**. * Edit **System Services - Voice**. * Set **Google Cloud** as **Default Text-to-Speech**. * Choose your preferred **Default Voice** for your setup. + +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=googletts +org.openhab.voice:defaultVoice=googletts:XXX +``` diff --git a/bundles/org.openhab.voice.mactts/README.md b/bundles/org.openhab.voice.mactts/README.md index 3389b91d9..2a7094ee3 100644 --- a/bundles/org.openhab.voice.mactts/README.md +++ b/bundles/org.openhab.voice.mactts/README.md @@ -37,6 +37,22 @@ mactts:Yuna Yuna (ko_KR) ... ``` +### Default Text-to-Speech and Voice Configuration + +You can setup your preferred default Text-to-Speech and default voice in the UI: + +* Go to **Settings**. +* Edit **System Services - Voice**. +* Set **macOS TTS** as **Default Text-to-Speech**. +* Choose your preferred **Default Voice** for your setup. + +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=mactts +org.openhab.voice:defaultVoice=mactts:Alex +``` + ## Supported Audio Formats The MacTTS service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth and 44.1kHz frequency. diff --git a/bundles/org.openhab.voice.marytts/README.md b/bundles/org.openhab.voice.marytts/README.md index 2d63e1eef..0a89178a5 100644 --- a/bundles/org.openhab.voice.marytts/README.md +++ b/bundles/org.openhab.voice.marytts/README.md @@ -21,6 +21,22 @@ marytts:bits3hsmm bits3-hsmm (de) marytts:bits1hsmm bits1-hsmm (de) ``` +### Default Text-to-Speech and Voice Configuration + +You can setup your preferred default Text-to-Speech and default voice in the UI: + +* Go to **Settings**. +* Edit **System Services - Voice**. +* Set **MaryTTS** as **Default Text-to-Speech**. +* Choose your preferred **Default Voice** for your setup. + +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=marytts +org.openhab.voice:defaultVoice=marytts:cmuslthsmm +``` + ## Supported Audio Formats The MaryTTS service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth. diff --git a/bundles/org.openhab.voice.picotts/README.md b/bundles/org.openhab.voice.picotts/README.md index 370ff0830..b97cfd69b 100644 --- a/bundles/org.openhab.voice.picotts/README.md +++ b/bundles/org.openhab.voice.picotts/README.md @@ -32,6 +32,22 @@ French (fr-FR) Italian (it-IT) ``` +### Default Text-to-Speech and Voice Configuration + +You can setup your preferred default Text-to-Speech and default voice in the UI: + +* Go to **Settings**. +* Edit **System Services - Voice**. +* Set **PicoTTS** as **Default Text-to-Speech**. +* Choose your preferred **Default Voice** for your setup. + +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=picotts +org.openhab.voice:defaultVoice=picotts:frFR +``` + ## Supported Audio Formats The Pico service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth. diff --git a/bundles/org.openhab.voice.pollytts/README.md b/bundles/org.openhab.voice.pollytts/README.md index b7a793dbd..a8f99d048 100644 --- a/bundles/org.openhab.voice.pollytts/README.md +++ b/bundles/org.openhab.voice.pollytts/README.md @@ -55,6 +55,22 @@ org.openhab.voice.pollytts:cacheExpiration=0 org.openhab.voice.pollytts:audioFormat=default ``` +### Default Text-to-Speech and Voice Configuration + +You can setup your preferred default Text-to-Speech and default voice in the UI: + +* Go to **Settings**. +* Edit **System Services - Voice**. +* Set **PollyTTS** as **Default Text-to-Speech**. +* Choose your preferred **Default Voice** for your setup. + +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=pollytts +org.openhab.voice:defaultVoice=pollytts:XXX +``` + ## Rule Examples ``` diff --git a/bundles/org.openhab.voice.voicerss/README.md b/bundles/org.openhab.voice.voicerss/README.md index f2eb48574..9da3b67fe 100644 --- a/bundles/org.openhab.voice.voicerss/README.md +++ b/bundles/org.openhab.voice.voicerss/README.md @@ -146,15 +146,22 @@ It supports the following voices (depending on language): * Omer (Turkish) * Chi (Vietnamese) -### Voice Configuration +### Default Text-to-Speech and Voice Configuration -You can setup your preferred default voice in the UI: +You can setup your preferred default Text-to-Speech and default voice in the UI: * Go to **Settings**. * Edit **System Services - Voice**. * Set **VoiceRSS** as **Default Text-to-Speech**. * Choose your preferred **Default Voice** for your setup. +In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries: + +``` +org.openhab.voice:defaultTTS=voicerss +org.openhab.voice:defaultVoice=voicerss:frFR_Zola +``` + ## Supported Audio Formats It supports the following audio formats: MP3, OGG, AAC and WAV.