https://github.com/pndurette/gtts

Python library and CLI tool to interface with Google Translate's text-to-speech API
https://github.com/pndurette/gtts

cli gtts pypi python python-library speech speech-api text-to-speech tts

Last synced: 15 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/pndurette/gtts
• Owner: pndurette
• License: mit
• Created: 2014-05-15T02:52:58.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-05-22T14:14:41.000Z (6 months ago)
• Last Synced: 2024-05-22T15:35:50.041Z (6 months ago)
• Topics: cli, gtts, pypi, python, python-library, speech, speech-api, text-to-speech, tts
• Language: Python
• Homepage: http://gtts.readthedocs.org/
• Size: 504 KB
• Stars: 2,163
• Watchers: 67
• Forks: 350
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

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`.

[![PyPI version](https://img.shields.io/pypi/v/gTTS.svg)](https://pypi.org/project/gTTS/)

[![Python versions](https://img.shields.io/pypi/pyversions/gTTS.svg)](https://pypi.org/project/gTTS/)

[![Tests workflow](https://github.com/pndurette/gtts/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/pndurette/gTTS/actions)

[![codecov](https://codecov.io/gh/pndurette/gTTS/branch/master/graph/badge.svg)](https://codecov.io/gh/pndurette/gTTS)

[![Commits Since](https://img.shields.io/github/commits-since/pndurette/gTTS/latest.svg)](https://github.com/pndurette/gTTS/commits/)

[![PyPi Downloads](https://static.pepy.tech/badge/gtts)](http://pepy.tech/project/gtts)

[![Buy me a Coffee](https://img.shields.io/badge/buy%20me%20a-coffee-orange)](https://www.buymeacoffee.com/pndurette)

## 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  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](https://translate.google.com) speech functionality and is *different* from [Google Cloud Text-to-Speech](https://cloud.google.com/text-to-speech/).

### Project

-   [Questions & community](https://github.com/pndurette/gTTS/discussions)

-   [Changelog](CHANGELOG.rst)

-   [Contributing](CONTRIBUTING.rst)

### Licence

[The MIT License (MIT)](LICENSE) Copyright © 2014-2024 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors)