Online Help: TextSound Command-Line Edition

The TextSound Command-Line Edition (TSC.EXE) is a 32-bit console application. It works like an MS-DOS program and doesn't have a window, but you need to run it under Windows 95, 98, NT4, Me, 2000 or XP.

• Syntax 1: <full path of TSC.EXE> voices
• Syntax 2: <full path of TSC.EXE> <text filename> <audio filename> <voice name>
• Syntax 3: <full path of TSC.EXE> <text filename> <audio filename> <voice name> <real-time speed> <voice speed> <voice pitch> <voice volume>
• Syntax Extension: As of TextSound 2.0, you can specify a text string as the conversion source directly instead of specifying a text filename. To do this, simply replace the <text filename> parameter with /s <text string>. See Example 4 below.

Note: TSC.EXE will produce audio files in the audio format configured in TextSound Windows Edition.

Parameters:

• <full path of TSC.EXE> : This is the full path of TSC.EXE. For example, if TextSound is installed in "C:\Program Files\TextSound", <full path of TSC.EXE> is "C:\Program Files\TextSound\TSC.EXE". Note that the quotation marks cannot be omitted if there are spaces in the full path.
• voices : If you use the phrase "voices" as the only parameter, TSC.EXE will display a list of computer voices installed on your computer and the number of these voices.
• <text filename> : This is the full path of your text file. For example, "C:\Temp\abc.txt". Note that the quotation marks cannot be omitted if there are spaces in the full path.
• <audio filename> : This is the fill path of the audio file. For example, "C:\Temp\abc.wav". Note that the quotation marks cannot be omitted if there are spaces in the full path.
• <voice name> : This is the text-to-speech voice you want to use. For example, "Mary". Note that the quotation marks cannot be omitted if there are spaces in the voice name, and the <voice name> parameter is case-sensitive. For example, "MARY" is not the same as "Mary".
• <real-time speed> : This indicates how quickly the text-to-speech engine writes to disk, ranging between 1 and 255. If omitted, the default value is 10. For more details, see "Real-Time Writing Speed" in the Help topic "Configuring Preferences".
• <voice speed> : This is the baseline average speed for the text-to-speech voice, in words per minute. If omitted, the default value is the specified voice's normal speed. For more details, see "Speed" in the Help topic "Editing Conversions".
• <voice pitch> : This is the baseline pitch for the text-to-speech voice, in hertz. If omitted, the default value is the specified voice's normal pitch. For more details, see "Pitch" in the Help topic "Editing Conversions".
• <voice volume> : This is the baseline speaking volume for the text-to-speech voice, ranging between 1 and 100. If omitted, the default value is 100. For more details, see "Volume" in the Help topic "Editing Conversions".

Examples: (The following examples assume that TextSound is installed in "C:\Program Files\TextSound".)

• 1) To list all voices installed on your computer: "C:\Program Files\TextSound\TSC.EXE" voices
• 2) To convert the text file C:\Temp\abc.txt to the audio file "C:\My Documents\abc.wav" using the Mary voice: "C:\Program Files\TextSound\TSC.EXE" C\Temp\abc.txt "C:\My Documents\abc.wav" Mary
• 3) To convert the text file "C:\My Documents\abc.txt" to the audio file "C:\My Documents\abc.wav" using the "Adult Male #1, American English (TruVoice)" voice, with real-time speed as 255, speed as 150 WPM, pitch as 50 Hz, volume as 100%: "C:\Program Files\TextSound\TSC.EXE" "C:\My Documents\abc.txt" "C:\My Documents\abc.wav" "Adult Male #1, American English (TruVoice)" 255 150 50 100
• 4) To specify a text string as the conversion source: "C:\Program Files\TextSound\TSC.EXE" /s "Hello world!" "C:\My Documents\hello.wav" Mike This will convert the text "Hello world!" to the file hello.wav using the Mike voice.

Related Links:

Download TextSound 2.0 Now!
Buy TextSound 2.0 Today!
Tell a Friend about CoolSpeech & TextSound!