config/modules/piper.conf

#
# Configuration for piper Speech Dispatcher output module.
#

# Debugging level (0 = disabled, 1 = errors only, 5 = full debug)
Debug 0

# -- Model Configuration --
#
# ModelPath is required. On Arch Linux (e.g. using the piper-voices-en-us package from AUR),
# voices are installed to /usr/share/piper-voices/<lang>/<locale>/<voice>/<quality>/.
#
# en_US-lessac-medium is the recommended standard default voice.
ModelPath "/usr/share/piper-voices/en/en_US/lessac/medium/en_US-lessac-medium.onnx"

# ConfigPath (optional):
# Path to the voice's JSON configuration file. If omitted, piper automatically
# looks for <ModelPath>.json.
# ConfigPath "/usr/share/piper-voices/en/en_US/lessac/medium/en_US-lessac-medium.onnx.json"

# -- Multi-Speaker Voice Selection (Optional) --
#
# For single-speaker models (like lessac), a single voice named after the model stem is exposed.
# For multi-speaker models (e.g., libritts_r, vctk, thorsten_emotional), each speaker defined in the
# model's "speaker_id_map" is exposed as an individual voice.
#
# Listing available speaker names:
#   1. Using the Speech Dispatcher CLI:
#        spd-say -o piper -L
#   2. Inspecting the model's JSON configuration file directly:
#        jq '.speaker_id_map | keys' /path/to/model.onnx.json
#
# DefaultVoice (optional):
# Sets the initial speaker for multi-speaker models using a speaker name from speaker_id_map.
# DefaultVoice "8419"
#
# AddVoice (optional):
# Maps standard Speech Dispatcher voice types (MALE1, FEMALE1, etc.) to specific speakers
# within a language code.
#
# Examples for multi-speaker models:
# AddVoice "en_US" "MALE1" "8419"
# AddVoice "en_US" "FEMALE1" "4137"
# AddVoice "de_DE" "MALE1" "neutral"
# AddVoice "de_DE" "MALE2" "amused"

# -- Sound Icons --
# Folder containing sound icon audio files (path must end with a trailing slash '/').
SoundIconFolder "/usr/share/sounds/sound-icons/"

# -- ESpeak NG Data Directory --
# Path to the espeak-ng-data directory used by Piper for phonemization.
# On Arch Linux, this is installed by the 'espeak-ng' package to /usr/share/espeak-ng-data/.
ESpeakNGDataDirPath "/usr/share/espeak-ng-data/"

# End of piper.conf