openhab-addons/bundles/org.openhab.voice.picotts/README.md
lsiepel 1a42353cc9
Multiple binding markdown fixes (#17422)
Signed-off-by: Leo Siepel <leosiepel@gmail.com>
2024-09-28 17:46:53 +02:00

56 lines
1.7 KiB
Markdown

# Pico Text-to-Speech
The Pico Text-to-Speech (TTS) service uses the TTS binary from SVOX for producing spoken text.
You manually need to install the pico2wave binary in order for this service to work correctly. You can,
e.g., install it with apt-get on an Ubuntu system:
```bash
sudo apt-get install libttspico-utils
```
In Arch Linux the pico2wave binaries are available in an Arch User repository (AUR) under
https://aur.archlinux.org/packages/svox-pico-bin/
## Configuration
There is no need to configure anything for this service.
## Voices
The following list are the only supported languages (as these are the languages supported by
pico2wave, see also [the documentation of the Debian package](https://packages.debian.org/de/wheezy/libttspico-utils)):
```
German (de-DE)
English, US (en-US)
English, GB (en-GB)
Spanish (es-ES)
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:
```ini
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.
## Caching
The Pico TTS service uses the openHAB TTS cache to cache audio files produced from the most recent queries in order to reduce traffic, improve performance and reduce number of requests.