termux-packages/packages/termux-api/termux-tts-speak

#!/bin/sh
set -e -u

SCRIPTNAME=termux-tts-speak
show_usage () {
    echo "Usage: $SCRIPTNAME [-e engine] [-l language] [-n region] [-v variant] [-p pitch] [-r rate] [-s stream] [text-to-speak]"
    echo "Speak text with a system text-to-speech (TTS) engine. The text to speak is either supplied as arguments or read from stdin if no arguments are given."
    echo ""
    echo "  -e engine    TTS engine to use (see termux-tts-engines)"
    echo "  -l language  language to speak in (may be unsupported by the engine)"
    echo "  -n region    region of language to speak in"
    echo "  -v variant   variant of the language to speak in"
    echo "  -p pitch     pitch to use in speech. 1.0 is the normal pitch,"
    echo "                 lower values lower the tone of the synthesized voice,"
    echo "                 greater values increase it."
    echo "  -r rate      speech rate to use. 1.0 is the normal speech rate,"
    echo "                 lower values slow down the speech"
    echo "                 (0.5 is half the normal speech rate)"
    echo "                 while greater values accelerates it"
    echo "                 (2.0 is twice the normal speech rate)."
    echo "  -s stream    audio stream to use (default:NOTIFICATION), one of:"
    echo "                 ALARM, MUSIC, NOTIFICATION, RING, SYSTEM, VOICE_CALL"
    echo ""
    exit 0
}

PARAMS=""

while getopts :he:l:n:v:p:r:s: option
do
    case "$option" in
        h) show_usage;;
        e) PARAMS="$PARAMS --es engine $OPTARG";;
        l) PARAMS="$PARAMS --es language $OPTARG";;
        n) PARAMS="$PARAMS --es region $OPTARG";;
        v) PARAMS="$PARAMS --es variant $OPTARG";;
        p) PARAMS="$PARAMS --ef pitch $OPTARG";;
        r) PARAMS="$PARAMS --ef rate $OPTARG";;
        s) PARAMS="$PARAMS --es stream $OPTARG";;
        ?) echo "$SCRIPTNAME: illegal option -$OPTARG"; exit 1;
    esac
done
shift $(($OPTIND-1))

CMD="@TERMUX_API@ TextToSpeech $PARAMS"
if [ $# = 0 ]; then
    $CMD
else
    echo $@ | $CMD
fi