gTTS logo

gTTS

pndurette/gTTS

Python library and CLI tool to interface with Google Translate's text-to-speech API

GraphCanon updated 3w · GitHub synced 3w · 29 views this month

2.6k stars386 forksLast push 4mo Python MIT

Decision brief

gTTS is a Python library and CLI tool that interfaces with Google Translate's text-to-speech API to convert text into speech and save it as an MP3 file.

Good fit when

  • You need to generate short audio clips from text dynamically within your applications without the overhead of setting up an official cloud service.
  • Your project focuses on simplicity in implementation, requiring minimal setup beyond installing a Python library and using simple commands or small code snippets.

Avoid when

  • You require advanced customization options for voice parameters such as pitch, speed, or gender which are more granular than what gTTS can provide.
  • Your application has legal constraints that prevent the use of unofficial APIs, or you need features backed by official support and service-level agreements from Google Cloud Text-to-Speech.
Pricing:
freemium - Free to use, no direct cost for using gTTS; any costs are passed on by Google in relation to usage of their API.

Observed Jul 17, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Slowing (114d since push)
As of 3w
Provenance
Not a fork · Personal account
As of 3w
Security (OSV)
No lockfile
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install gTTS
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

gTTS is a Python-based text-to-speech conversion utility that can write audio data directly into MP3 files for later use in applications or as standalone media.

Capability facts

CLI
CLI entrypoint

Source: pyproject.toml:[project.scripts] · Jul 29, 2026

Languages
python

Source: github.language+pyproject.toml · Jul 29, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Python runtimePython

Source: README excerpt (regex_v1, Jul 29, 2026)

**gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API.
Source link

Tags

README

gTTS

gTTS (Google Text-to-Speech), a Python library and CLI tool to interface with Google Translate's text-to-speech API. Write spoken mp3 data to a file, a file-like object (bytestring) for further audio manipulation, or stdout. https://gtts.readthedocs.io/

Features

  • Customizable speech-specific sentence tokenizer that allows for unlimited lengths of text to be read, all while keeping proper intonation, abbreviations, decimals and more;
  • Customizable text pre-processors which can, for example, provide pronunciation corrections;

Installation

$ pip install gTTS

Quickstart

Command Line:

$ gtts-cli 'hello' --output hello.mp3

Module:

>>> from gtts import gTTS
>>> tts = gTTS('hello')
>>> tts.save('hello.mp3')

See https://gtts.readthedocs.io/ for documentation and examples.

Disclaimer

This project is not affiliated with Google or Google Cloud. Breaking upstream changes can occur without notice. This project is leveraging the undocumented Google Translate speech functionality and is different from Google Cloud Text-to-Speech.

Project

Licence

The MIT License (MIT) Copyright © 2014-2024 Pierre Nicolas Durette & Contributors

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.