# pndurette/gTTS

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

Repository: https://github.com/pndurette/gTTS
Canonical: https://ross.abutalabs.com/products/gtts
Homepage: http://gtts.readthedocs.org/
Language: Python
License: MIT
License Family: permissive
Topics: speech, python, tts, text-to-speech, gtts, speech-api, cli, python-library, pypi
Last push: 2026-04-06T01:34:42+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 75, release rhythm 8, longevity 100
- inputs: {"age_days": 4493, "days_push": 150, "days_rel": 661, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2627, forks 389 (observed 2026-08-28T04:07:05.423743+00:00)

## What it is
gTTS is a Python library and CLI tool that interfaces with Google Translate's text-to-speech API to generate spoken MP3 audio from text. It supports unlimited text lengths via sentence tokenization and customizable text pre-processors for pronunciation corrections.

## Use cases
- convert text to speech mp3 in python
- read a long article aloud as audio
- generate voice audio files from text
- add text-to-speech to a python script
- pronounce words for a language learning app
- save spoken audio to stdout or a file-like object

## When to choose
- you want a simple, free way to synthesize speech via Google Translate's endpoint
- you need both a Python API and a command-line tool
- you need to handle long text with proper sentence tokenization

## When to avoid
- you need a supported, SLA-backed cloud TTS service (use Google Cloud Text-to-Speech)
- you need offline or on-device speech synthesis
- you cannot tolerate breakage from undocumented upstream API changes

## Facets
- artifact type: library
- maturity: stable
- function: tts, cli, audio-processing
- domain: speech-processing, developer-tools
- platform: python, cli, cross-platform
- tags: google-translate, mp3, text-to-speech, python-library, speech-api, natural-language-processing

## Member repositories
- pndurette/gTTS (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:05.423743+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:19:45.287509+00:00, confidence not recorded.
  - readme: https://github.com/pndurette/gTTS (fetched 2026-08-28T04:07:05.423743+00:00, sha 24127757747e)
  - registry_pypi: https://pypi.org/pypi/gtts/json (fetched 2026-08-29T10:03:13.080081+00:00, sha 53b6c7f6f939)
- Data as of 2026-08-30T08:39:29.467469+00:00.