| 1 |
Metadata-Version: 2.1 |
| 2 |
Name: gTTS |
| 3 |
Version: 2.5.4 |
| 4 |
Summary: gTTS (Google Text-to-Speech), a Python library and CLI tool to interface with Google Translate text-to-speech API |
| 5 |
Author-email: Pierre Nicolas Durette <[email protected]> |
| 6 |
License: MIT |
| 7 |
Project-URL: homepage, https://github.com/pndurette/gTTS |
| 8 |
Project-URL: documentation, https://gtts.readthedocs.io |
| 9 |
Project-URL: repository, https://github.com/pndurette/gTTS |
| 10 |
Project-URL: changelog, https://github.com/pndurette/gTTS/blob/main/CHANGELOG.md |
| 11 |
Keywords: gtts,text to speech,Google Translate,TTS |
| 12 |
Classifier: Environment :: Console |
| 13 |
Classifier: Intended Audience :: Developers |
| 14 |
Classifier: License :: OSI Approved :: MIT License |
| 15 |
Classifier: Operating System :: MacOS |
| 16 |
Classifier: Operating System :: Unix |
| 17 |
Classifier: Operating System :: POSIX |
| 18 |
Classifier: Operating System :: POSIX :: Linux |
| 19 |
Classifier: Operating System :: Microsoft :: Windows |
| 20 |
Classifier: Programming Language :: Python :: 3.8 |
| 21 |
Classifier: Programming Language :: Python :: 3.9 |
| 22 |
Classifier: Programming Language :: Python :: 3.10 |
| 23 |
Classifier: Programming Language :: Python :: 3.11 |
| 24 |
Classifier: Programming Language :: Python :: 3.12 |
| 25 |
Classifier: Topic :: Software Development :: Libraries |
| 26 |
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech |
| 27 |
Requires-Python: >=3.7 |
| 28 |
Description-Content-Type: text/markdown |
| 29 |
License-File: LICENSE |
| 30 |
Requires-Dist: requests<3,>=2.27 |
| 31 |
Requires-Dist: click<8.2,>=7.1 |
| 32 |
Provides-Extra: tests |
| 33 |
Requires-Dist: pytest<8.4.0,>=7.1.3; extra == "tests" |
| 34 |
Requires-Dist: pytest-cov; extra == "tests" |
| 35 |
Requires-Dist: testfixtures; extra == "tests" |
| 36 |
Provides-Extra: docs |
| 37 |
Requires-Dist: sphinx; extra == "docs" |
| 38 |
Requires-Dist: sphinx-autobuild; extra == "docs" |
| 39 |
Requires-Dist: sphinx_rtd_theme; extra == "docs" |
| 40 |
Requires-Dist: sphinx-click; extra == "docs" |
| 41 |
Requires-Dist: sphinx-mdinclude; extra == "docs" |
| 42 |
|
| 43 |
# gTTS |
| 44 |
|
| 45 |
**gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API. |
| 46 |
Write spoken `mp3` data to a file, a file-like object (bytestring) for further audio manipulation, or `stdout`. |
| 47 |
<https://gtts.readthedocs.io/> |
| 48 |
|
| 49 |
[](https://pypi.org/project/gTTS/) |
| 50 |
[](https://pypi.org/project/gTTS/) |
| 51 |
[](https://github.com/pndurette/gTTS/actions) |
| 52 |
[](https://codecov.io/gh/pndurette/gTTS) |
| 53 |
[](https://github.com/pndurette/gTTS/commits/) |
| 54 |
[](http://pepy.tech/project/gtts) |
| 55 |
[](https://www.buymeacoffee.com/pndurette) |
| 56 |
|
| 57 |
## Features |
| 58 |
|
| 59 |
- Customizable speech-specific sentence tokenizer that allows for unlimited lengths of text to be read, all while keeping proper intonation, abbreviations, decimals and more; |
| 60 |
- Customizable text pre-processors which can, for example, provide pronunciation corrections; |
| 61 |
|
| 62 |
### Installation |
| 63 |
|
| 64 |
$ pip install gTTS |
| 65 |
|
| 66 |
### Quickstart |
| 67 |
|
| 68 |
Command Line: |
| 69 |
|
| 70 |
$ gtts-cli 'hello' --output hello.mp3 |
| 71 |
|
| 72 |
Module: |
| 73 |
|
| 74 |
>>> from gtts import gTTS |
| 75 |
>>> tts = gTTS('hello') |
| 76 |
>>> tts.save('hello.mp3') |
| 77 |
|
| 78 |
See <https://gtts.readthedocs.io/> for documentation and examples. |
| 79 |
|
| 80 |
### Disclaimer |
| 81 |
|
| 82 |
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/). |
| 83 |
|
| 84 |
### Project |
| 85 |
|
| 86 |
- [Questions & community](https://github.com/pndurette/gTTS/discussions) |
| 87 |
- [Changelog](CHANGELOG.rst) |
| 88 |
- [Contributing](CONTRIBUTING.rst) |
| 89 |
|
| 90 |
### Licence |
| 91 |
|
| 92 |
[The MIT License (MIT)](LICENSE) Copyright © 2014-2024 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors) |