gTTS


NamegTTS JSON
Version 2.5.4 PyPI version JSON
download
home_pageNone
SummarygTTS (Google Text-to-Speech), a Python library and CLI tool to interface with Google Translate text-to-speech API
upload_time2024-11-10 21:58:00
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseMIT
keywords gtts text to speech google translate tts
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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/>

[![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 <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](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)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "gTTS",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "gtts, text to speech, Google Translate, TTS",
    "author": null,
    "author_email": "Pierre Nicolas Durette <pndurette@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/57/79/5ddb1dfcd663581d0d3fca34ccb1d8d841b47c22a24dc8dce416e3d87dfa/gtts-2.5.4.tar.gz",
    "platform": null,
    "description": "# gTTS\n\n**gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API. \nWrite spoken `mp3` data to a file, a file-like object (bytestring) for further audio manipulation, or `stdout`.\n<https://gtts.readthedocs.io/>\n\n[![PyPI version](https://img.shields.io/pypi/v/gTTS.svg)](https://pypi.org/project/gTTS/)\n[![Python versions](https://img.shields.io/pypi/pyversions/gTTS.svg)](https://pypi.org/project/gTTS/)\n[![Tests workflow](https://github.com/pndurette/gtts/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/pndurette/gTTS/actions)\n[![codecov](https://codecov.io/gh/pndurette/gTTS/branch/master/graph/badge.svg)](https://codecov.io/gh/pndurette/gTTS)\n[![Commits Since](https://img.shields.io/github/commits-since/pndurette/gTTS/latest.svg)](https://github.com/pndurette/gTTS/commits/)\n[![PyPi Downloads](https://static.pepy.tech/badge/gtts)](http://pepy.tech/project/gtts)\n[![Buy me a Coffee](https://img.shields.io/badge/buy%20me%20a-coffee-orange)](https://www.buymeacoffee.com/pndurette)\n\n## Features\n\n-   Customizable speech-specific sentence tokenizer that allows for unlimited lengths of text to be read, all while keeping proper intonation, abbreviations, decimals and more;\n-   Customizable text pre-processors which can, for example, provide pronunciation corrections;\n\n### Installation\n\n    $ pip install gTTS\n\n### Quickstart\n\nCommand Line:\n\n    $ gtts-cli 'hello' --output hello.mp3\n\nModule:\n\n    >>> from gtts import gTTS\n    >>> tts = gTTS('hello')\n    >>> tts.save('hello.mp3')\n\nSee <https://gtts.readthedocs.io/> for documentation and examples.\n\n### Disclaimer\n\nThis 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/).\n\n### Project\n\n-   [Questions & community](https://github.com/pndurette/gTTS/discussions)\n-   [Changelog](CHANGELOG.rst)\n-   [Contributing](CONTRIBUTING.rst)\n\n### Licence\n\n[The MIT License (MIT)](LICENSE) Copyright \u00a9 2014-2024 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "gTTS (Google Text-to-Speech), a Python library and CLI tool to interface with Google Translate text-to-speech API",
    "version": "2.5.4",
    "project_urls": {
        "changelog": "https://github.com/pndurette/gTTS/blob/main/CHANGELOG.md",
        "documentation": "https://gtts.readthedocs.io",
        "homepage": "https://github.com/pndurette/gTTS",
        "repository": "https://github.com/pndurette/gTTS"
    },
    "split_keywords": [
        "gtts",
        " text to speech",
        " google translate",
        " tts"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e36c8b8b1fdcaee7e268536f1bb00183a5894627726b54a9ddc6fc9909888447",
                "md5": "e75ec6127d3c9daabd8fe908783225c3",
                "sha256": "5dd579377f9f5546893bc26315ab1f846933dc27a054764b168f141065ca8436"
            },
            "downloads": -1,
            "filename": "gTTS-2.5.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e75ec6127d3c9daabd8fe908783225c3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 29184,
            "upload_time": "2024-11-10T21:57:58",
            "upload_time_iso_8601": "2024-11-10T21:57:58.448724Z",
            "url": "https://files.pythonhosted.org/packages/e3/6c/8b8b1fdcaee7e268536f1bb00183a5894627726b54a9ddc6fc9909888447/gTTS-2.5.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "57795ddb1dfcd663581d0d3fca34ccb1d8d841b47c22a24dc8dce416e3d87dfa",
                "md5": "e866c23894f3ef19ce217d84bde68a37",
                "sha256": "f5737b585f6442f677dbe8773424fd50697c75bdf3e36443585e30a8d48c1884"
            },
            "downloads": -1,
            "filename": "gtts-2.5.4.tar.gz",
            "has_sig": false,
            "md5_digest": "e866c23894f3ef19ce217d84bde68a37",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 24018,
            "upload_time": "2024-11-10T21:58:00",
            "upload_time_iso_8601": "2024-11-10T21:58:00.358899Z",
            "url": "https://files.pythonhosted.org/packages/57/79/5ddb1dfcd663581d0d3fca34ccb1d8d841b47c22a24dc8dce416e3d87dfa/gtts-2.5.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-10 21:58:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pndurette",
    "github_project": "gTTS",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "gtts"
}
        
Elapsed time: 0.61386s