readme.md

decent-node-gtts

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

How to install

npm install decent-node-gtts

How to use

1. Save audio file

var gtts = require('decent-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');
})

2. Pipe directly to router response

Example with ExpressJS Router

var express = require('express');
var router = express.Router();
var gtts = require('decent-node-gtts')('en');

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

3. Create a standalone server

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

4. Command line usage

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

# create server listen port 8668
# (in English by default)
decent-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