/gTTS

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

Primary LanguagePythonMIT LicenseMIT

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. Or simply pre-generate Google Translate TTS request URLs to feed to an external program. http://gtts.readthedocs.org/

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

See http://gtts.readthedocs.org/ for documentation and examples.

Project

Licence

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