[TTS services] Enhance doc to explain how to setup default voice (#12099)

Signed-off-by: Laurent Garnier <lg.hc@free.fr>

diff --git a/bundles/org.openhab.voice.googletts/README.md b/bundles/org.openhab.voice.googletts/README.md
index a8ad7a6349181ee0a1dd9098298309ea06a5e128..80aa66fe625ab42273b124a0369ed245ebb23240 100644 (file)
--- 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 3389b91d935a8886660eff2d715b0658fb60bdeb..2a7094ee35043cd43baa838d23039d1b04aa7f21 100644 (file)
--- 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 2d63e1eef1fa14672a327960d182cfa5a3f2d45d..0a89178a559fa82a05ed6aea1dc41c002a1edcb6 100644 (file)
--- 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 370ff08308c8e0b460e3fb2469a77119b498efdd..b97cfd69b292cba2d7b23b90cd0b226a1d0220e7 100644 (file)
--- 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 b7a793dbdeb7a5243e23d6f59f2498aec79ee16b..a8f99d0488490cf62164e42cfeb2cbcb6b365060 100644 (file)
--- 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 f2eb48574d7249268290303dbfad6bcd272c9766..9da3b67fe00beae8f2b435ed546cb3af34a9d8d0 100644 (file)
--- 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.