node-gtts

Google Text-to-Speech for NodeJS (Unofficial API)

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
node-gtts
2432.0.26 years ago6 years agoMinified + gzip package size for node-gtts in KB

Readme

node-gtts
Google Text-to-Speech for NodeJS (Unofficial API)

How to install

npm install node-gtts

How to use

  1. Save audio file

var gtts = require('node-gtts')('en');
var path = require('path');
var filepath = path.join(__dirname, 'i-love-you.wav');

gtts.save(filepath, 'I love you', function() {
  console.log('save done');
})

  1. Pipe directly to router response

Example with ExpressJS Router
var express = require('express');
var router = express.Router();
var gtts = require('node-gtts')('en');

router.get('/speech', function(req, res) {
  res.set({'Content-Type': 'audio/mpeg'});
  gtts.stream(req.query.text).pipe(res);
})

  1. Create a standalone server

var gtts = require('node-gtts')('en');
gtts.createServer(8668);

  1. Command line usage

# create file: helllo-world.wav
node-gtts en Hello World

# create server listen port 8668
# (in English by default)
node-gtts serve 8668 en

API for standalone server

GET /?text={your-text}
  • stream audio of speech with default language

GET /?text={your-text}?lang={lang}
  • stream audio of speech with specific language