lino-levan / better-node-gtts

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

better-node-gtts

This is a better version of node-gtts (Unofficial API)

How to install

npm install better-node-gtts

How to use

1. Save audio file

var gtts = require("better-node-gtts").default;
var filepath = "./i-love-you.wav";

gtts.save(filepath, "I love you")
  .then(() => {
    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("better-node-gtts").default;

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("better-node-gtts").default;
gtts.createServer(8668);

4. Command line usage

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

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