gspeak

Google Text to Speech for Node.js

A TypeScript rewrite of gtts — drop-in compatible.

✨ Features

• 🔊 Convert any text to speech using Google TTS
• 🔷 Full TypeScript support
• 🔗 Drop-in replacement for gtts
• 🌍 81 languages supported
• 💾 Save to file or stream directly
• 🖥️ CLI included

📦 Installation

npm i gspeak

🚀 Quick Start

import { gSpeak } from 'gspeak'

const tts = new gSpeak('Hello world', 'en')
tts.save('/tmp/hello.mp3', (err) => {
  if (err) throw err
  console.log('Saved to /tmp/hello.mp3')
})

📥 Import

import { gSpeak } from 'gspeak'         // ESM ✅

const { gSpeak } = require('gspeak')     // CJS ✅

const gSpeak = require('gspeak').default   // CJS ✅

📖 Usage

Save to file

import { gSpeak } from 'gspeak'

const tts = new gSpeak('Text to speak', 'en')
tts.save('/tmp/output.mp3', (err) => {
  if (err) throw err
  console.log('Done!')
})

Stream (e.g. with Express)

import express from 'express'
import { gSpeak } from 'gspeak'

const app = express()

app.get('/speak', (req, res) => {
  const tts = new gSpeak(req.query.text as string, req.query.lang as string)
  tts.stream().pipe(res)
})

app.listen(3000, () => {
  console.log('http://localhost:3000/speak?lang=en&text=Hello')
})

List all supported languages

import { LANGUAGES } from 'gspeak'

console.log(LANGUAGES)
// { af: 'Afrikaans', sq: 'Albanian', ... }

// or via the static getter
import { gSpeak } from 'gspeak'
console.log(gSpeak.languages)

Debug mode

const tts = new gSpeak('Hello', 'en', true) // 3rd param enables debug logging

🖥️ CLI

npm install -g gspeak
gspeak "Hello Google Text to Speech" -l en -o /tmp/hello.mp3

| Flag | Alias | Description | |------|-------|-------------| | --language | -l | Language code (default: en) | | --output | -o | Output file path (required) | | --verbose | -v | Print debug messages |

🌍 Supported Languages (81 total)

| Code | Language | |------|----------| | af | Afrikaans | | sq | Albanian | | am | Amharic | | ar | Arabic | | eu | Basque | | bn | Bengali | | bs | Bosnian | | bg | Bulgarian | | my | Burmese | | ca | Catalan | | zh | Chinese | | zh-cn | Chinese (Simplified) | | zh-tw | Chinese (Traditional) | | zh-yue | Chinese (Cantonese) | | hr | Croatian | | cs | Czech | | da | Danish | | nl | Dutch | | en | English | | en-au | English (Australia) | | en-ca | English (Canada) | | en-in | English (India) | | en-ie | English (Ireland) | | en-uk | English (United Kingdom) | | en-us | English (United States) | | en-za | English (South Africa) | | et | Estonian | | fil | Filipino | | fi | Finnish | | fr | French | | fr-ca | French (Canada) | | fr-fr | French (France) | | gl | Galician | | de | German | | el | Greek | | gu | Gujarati | | ha | Hausa | | iw | Hebrew | | hi | Hindi | | hu | Hungarian | | is | Icelandic | | id | Indonesian | | it | Italian | | ja | Japanese | | jw | Javanese | | kn | Kannada | | km | Khmer | | ko | Korean | | la | Latin | | lv | Latvian | | lt | Lithuanian | | ms | Malay | | ml | Malayalam | | mr | Marathi | | ne | Nepali | | no | Norwegian | | pl | Polish | | pt | Portuguese | | pt-br | Portuguese (Brazil) | | pt-pt | Portuguese (Portugal) | | pa | Punjabi | | ro | Romanian | | ru | Russian | | sr | Serbian | | si | Sinhala | | sk | Slovak | | es | Spanish | | es-es | Spanish (Spain) | | es-us | Spanish (United States) | | su | Sundanese | | sw | Swahili | | sv | Swedish | | tl | Tagalog | | ta | Tamil | | te | Telugu | | th | Thai | | tr | Turkish | | uk | Ukrainian | | ur | Urdu | | vi | Vietnamese | | cy | Welsh |

🔄 Migrating from gtts

gspeak is a drop-in replacement. Just change the import:

// before
const gTTS = require('gtts')
const tts = new gTTS('Hello', 'en')

// after
const { gSpeak } = require('gspeak')
const tts = new gSpeak('Hello', 'en')

Same constructor, same .save(), same .stream() — nothing else changes.

📄 License

MIT © Qasim Ali

Made with ❤️ — Thanks for using gspeak!