// automatically pick platformconst say = require('say')// or, override the platformconst Say = require('say').Sayconst say = new Say('darwin' || 'win32' || 'linux')// Use default system voice and speedsay.speak('Hello!')// Stop the text currently being spokensay.stop()// More complex example (with an OS X voice) and slow speedsay.speak("What's up, dog?", 'Alex', 0.5)// Fire a callback once the text has completed being spokensay.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 filesay.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.')})
Unfortunately every feature isn't supported on every platform. PR's welcome!
Platform
Speak
Export
Stop
Speed
Voice
List
macOS
:white_check_mark:
:white_check_mark:
:white_check_mark:
:white_check_mark:
:white_check_mark:
:no_entry_sign:
Linux
:white_check_mark:
:no_entry_sign:
:white_check_mark:
:white_check_mark:
:white_check_mark:
:no_entry_sign:
Windows
:white_check_mark:
:white_check_mark:
:white_check_mark:
:white_check_mark:
:white_check_mark:
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
None.
Linux Notes
Linux support requires Festival. As far as I can tell there is no sane way to get a list of available voices. The only voice that seems to work is voice_kal_diphone, which seems to be the default anyway.
The .export() method is not available.
Try the following command 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)
Needs to have Powershell installed and available in $PATH (see issue #75)