say

Convert text to audible speech.
This tool uses the Speech Synthesis manager to convert input text to audible speech and either play it through the sound output device chosen in System Preferences or save it to an AIFF file.

Syntax
       say [-v voice] [-o out.aiff | -n name:port ] [-f file | string ...]

Options

   string   The text to speak on the command line.
			 This can consist of multiple arguments, which are
	         considered to be separated by spaces.

   -f file	 A file to be spoken.
            If file is - or neither this parameter nor a message
            is specified, read from standard input.

   -v voice The voice to be used.
            Default is the voice selected in System Preferences.

   -o out.aiff
            An AIFF file to be written.

   -n name
-n name:port
-n :port
-n :
Specify a service name (default "AUNetSend") and/or IP port to be
used for redirecting the speech output through AUNetSend.

If the input is a TTY, text is spoken line by line, and the output file, if specified, will only contain audio for the last line of the input. Otherwise, text is spoken all at once.

Returns 0 if the text was spoken successfully, otherwise non-zero.
Diagnostic messages will be printed to standard error.

"One look is worth a thousand words" - Fred R. Barnard

Related:

echo - Display message on screen
pr - Convert text files for printing
textutil - Manipulate text files in various formats



Back to the Top

Simon Sheppard
SS64.com