say

Installing say.js

npm install say

Usage

var say = require('say');

// Use default system voice and speed
say.speak('Hello!');

// Stop the text currently being spoken
say.stop();

// More complex example (with an OS X voice) and slow speed
say.speak('whats up, dog?', 'Alex', 20);

// Fire a callback once the text has completed being spoken
say.speak('whats up, dog?', 'Good News', null, function(err) {
  if (err) {
    return console.error(err);
  }

  console.log('Text has been spoken.');
});

// Export spoken audio to a WAV file
say.export("I'm sorry, Dave.", 'Cellos', 150, 'hal.wav', function(err) {
  if (err) {
    return console.error(err);
  }

  console.log('Text has been saved to hal.wav.');
});

OS X Notes

Speed is based on the average number of words spoken per minute. The OS X say command seems to default to 175.

Feminine Voices

Agnes, Kathy, Princess, Vicki, Victoria

Masculine Voices

Albert, Alex, Bruce, Fred, Junior, Ralph

Miscellaneous Voices

Bad News, Bahh, Bells, Boing, Bubbles, Cellos, Deranged, Good News, Hysterical, Pipe Organ, Trinoids, Whisper, Zarvox

Windows Notes

Voice parameter is not yet available. Uses whatever default system voice is set, ignoring voice parameter. Speed parameter is not yet available.

The export method is not available.

Linux Notes

Linux support involves the use of Festival, which uses decidedly less friendly names for its voices. Voices for Festival sometimes need to be installed separately - you can check which voices are available by starting up Festival in interactive mode, typing (voice_, and pressing TAB. Then take the name of the voice you'd like to try, minus the parentheses, and pass it in to say.js.

Speed is a percent based upon the normal rate, so 50 is 50%, 120 is 120%, etc. This differs from OS X.

The export method is not yet available.

Try the following commad to install Festival as well as a default voice:

sudo apt-get install festival festvox-kallpc16k

Requirements

• Mac OS X (comes with say)
• Linux with Festival installed
• Windows (comes with SAPI.SpVoice)