# 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": "https://github.com/blket.dev/diTTS",
"name": "diTTS",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "ditts,text to speech,NAVER Papago,TTS",
"author": "blket.dev",
"author_email": "blket.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8d/5d/c33d98186646c7af01f1da76e1513cdf40c0c510310a2ab6afcdfdf48790/diTTS-2.6.7.tar.gz",
"platform": null,
"description": "# gTTS\r\n\r\n**gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API. \r\nWrite spoken `mp3` data to a file, a file-like object (bytestring) for further audio manipulation, or `stdout`.\r\n<https://gtts.readthedocs.io/>\r\n\r\n[![PyPI version](https://img.shields.io/pypi/v/gTTS.svg)](https://pypi.org/project/gTTS/)\r\n[![Python versions](https://img.shields.io/pypi/pyversions/gTTS.svg)](https://pypi.org/project/gTTS/)\r\n[![Tests workflow](https://github.com/pndurette/gtts/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/pndurette/gTTS/actions)\r\n[![codecov](https://codecov.io/gh/pndurette/gTTS/branch/master/graph/badge.svg)](https://codecov.io/gh/pndurette/gTTS)\r\n[![Commits Since](https://img.shields.io/github/commits-since/pndurette/gTTS/latest.svg)](https://github.com/pndurette/gTTS/commits/)\r\n[![PyPi Downloads](https://static.pepy.tech/badge/gtts)](http://pepy.tech/project/gtts)\r\n[![Buy me a Coffee](https://img.shields.io/badge/buy%20me%20a-coffee-orange)](https://www.buymeacoffee.com/pndurette)\r\n\r\n## Features\r\n\r\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;\r\n- Customizable text pre-processors which can, for example, provide pronunciation corrections;\r\n\r\n### Installation\r\n\r\n $ pip install gTTS\r\n\r\n### Quickstart\r\n\r\nCommand Line:\r\n\r\n $ gtts-cli 'hello' --output hello.mp3\r\n\r\nModule:\r\n\r\n >>> from gtts import gTTS\r\n >>> tts = gTTS('hello')\r\n >>> tts.save('hello.mp3')\r\n\r\nSee <https://gtts.readthedocs.io/> for documentation and examples.\r\n\r\n### Disclaimer\r\n\r\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/).\r\n\r\n### Project\r\n\r\n- [Questions & community](https://github.com/pndurette/gTTS/discussions)\r\n- [Changelog](CHANGELOG.rst)\r\n- [Contributing](CONTRIBUTING.rst)\r\n\r\n### Licence\r\n\r\n[The MIT License (MIT)](LICENSE) Copyright \uc9e4 2014-2024 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "diTTS (Google Text-to-Speech), a Python library and CLI tool to interface with Google Translate text-to-speech API",
"version": "2.6.7",
"project_urls": {
"Homepage": "https://github.com/blket.dev/diTTS"
},
"split_keywords": [
"ditts",
"text to speech",
"naver papago",
"tts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b6116fbfaf35a2691a79b6d6614ac33640f490387277d1147cd388edea4335a3",
"md5": "baeecdd939a16e0e28c8975b94c31085",
"sha256": "6e563b35df018a42fe25e5412d582dcd63a22c2cc520ad060c8a9575322e1f78"
},
"downloads": -1,
"filename": "diTTS-2.6.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "baeecdd939a16e0e28c8975b94c31085",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 26297,
"upload_time": "2024-02-01T14:42:35",
"upload_time_iso_8601": "2024-02-01T14:42:35.924935Z",
"url": "https://files.pythonhosted.org/packages/b6/11/6fbfaf35a2691a79b6d6614ac33640f490387277d1147cd388edea4335a3/diTTS-2.6.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8d5dc33d98186646c7af01f1da76e1513cdf40c0c510310a2ab6afcdfdf48790",
"md5": "4009890a4ca2a9a3c1f74ca9857474df",
"sha256": "9a4fec398eaaaa3603c1eaed2d2f58fc43f1e7995ce93dab75e22224c6142d8d"
},
"downloads": -1,
"filename": "diTTS-2.6.7.tar.gz",
"has_sig": false,
"md5_digest": "4009890a4ca2a9a3c1f74ca9857474df",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 22525,
"upload_time": "2024-02-01T14:42:37",
"upload_time_iso_8601": "2024-02-01T14:42:37.969235Z",
"url": "https://files.pythonhosted.org/packages/8d/5d/c33d98186646c7af01f1da76e1513cdf40c0c510310a2ab6afcdfdf48790/diTTS-2.6.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-01 14:42:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "blket.dev",
"github_project": "diTTS",
"github_not_found": true,
"lcname": "ditts"
}