Skip to content
/ gTTS Public

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

License

Notifications You must be signed in to change notification settings

pndurette/gTTS

Repository files navigation

gTTS

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

PyPI version Python versions Tests workflow codecov Commits Since PyPi Downloads Buy me a Coffee

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')

Seehttps://gtts.readthedocs.io/for documentation and examples.

Disclaimer

This project isnotaffiliated with Google or Google Cloud. Breaking upstream changescanoccur without notice. This project is leveraging the undocumentedGoogle Translatespeech functionality and isdifferentfromGoogle Cloud Text-to-Speech.

Project

Licence

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