say.js

Installing say.js

npm install say

Usage

const 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("What's up, dog?", 'Alex', 0.5)

// Fire a callback once the text has completed being spoken
say.speak("What's up, dog?", 'Good News', 1.0, (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', 0.75, 'hal.wav', (err) => {
  if (err) {
    return console.error(err)
  }

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

Methods

Override Platform:

say.setPlatform(say.platforms.WIN32 || say.platforms.MACOS || say.platforms.LINUX)

Speak:

• Speed: 1 = 100%, 0.5 = 50%, 2 = 200%, etc

say.speak(text, voice || null, speed || null, callback || null)

Export Audio:

• MacOS Only
• Speed: 1 = 100%, 0.5 = 50%, 2 = 200%, etc

say.export(text, voice || null, speed || null, filename, callback || null)

Stop Speaking:

say.stop(callback || null)

Feature Matrix

Unfortunately every feature isn't suppored on every platform. PR's welcome!

Platform	Speak	Export	Stop	Speed	Voice
macOS	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
Linux	:white_check_mark:	:no_entry_sign:	:white_check_mark:	:white_check_mark:	:white_check_mark:
Windows	:white_check_mark:	:no_entry_sign:	:white_check_mark:	:no_entry_sign:	:no_entry_sign:

macOS Notes

Voices in macOS are associated with different localities. To a list of voices and their localities run the following command:

say -v "?"

As an example, the default voice is Alex and the voice used by Siri is Samantha.

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 requires Festival, which uses less friendly names for its voices. Voices for Festival sometimes need to be installed separately. You can check which voices are available by running festival, 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.

The .export() method is not available.

Try the following commad to install Festival with 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)