METADATA 4.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. Metadata-Version: 2.1
  2. Name: gTTS
  3. Version: 2.5.0
  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 <pndurette@gmail.com>
  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: docs
  33. Requires-Dist: sphinx ; extra == 'docs'
  34. Requires-Dist: sphinx-autobuild ; extra == 'docs'
  35. Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
  36. Requires-Dist: sphinx-click ; extra == 'docs'
  37. Requires-Dist: sphinx-mdinclude ; extra == 'docs'
  38. Provides-Extra: tests
  39. Requires-Dist: pytest ~=7.1.3 ; extra == 'tests'
  40. Requires-Dist: pytest-cov ; extra == 'tests'
  41. Requires-Dist: testfixtures ; extra == 'tests'
  42. # gTTS
  43. **gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API.
  44. Write spoken `mp3` data to a file, a file-like object (bytestring) for further audio manipulation, or `stdout`.
  45. <http://gtts.readthedocs.org/>
  46. [![PyPI version](https://img.shields.io/pypi/v/gTTS.svg)](https://pypi.org/project/gTTS/)
  47. [![Python versions](https://img.shields.io/pypi/pyversions/gTTS.svg)](https://pypi.org/project/gTTS/)
  48. [![Tests workflow](https://github.com/pndurette/gtts/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/pndurette/gTTS/actions)
  49. [![codecov](https://codecov.io/gh/pndurette/gTTS/branch/master/graph/badge.svg)](https://codecov.io/gh/pndurette/gTTS)
  50. [![Commits Since](https://img.shields.io/github/commits-since/pndurette/gTTS/latest.svg)](https://github.com/pndurette/gTTS/commits/)
  51. [![PyPi Downloads](https://static.pepy.tech/badge/gtts)](http://pepy.tech/project/gtts)
  52. [![Buy me a Coffee](https://img.shields.io/badge/buy%20me%20a-coffee-orange)](https://www.buymeacoffee.com/pndurette)
  53. ## Features
  54. - Customizable speech-specific sentence tokenizer that allows for unlimited lengths of text to be read, all while keeping proper intonation, abbreviations, decimals and more;
  55. - Customizable text pre-processors which can, for example, provide pronunciation corrections;
  56. ### Installation
  57. $ pip install gTTS
  58. ### Quickstart
  59. Command Line:
  60. $ gtts-cli 'hello' --output hello.mp3
  61. Module:
  62. >>> from gtts import gTTS
  63. >>> tts = gTTS('hello')
  64. >>> tts.save('hello.mp3')
  65. See <http://gtts.readthedocs.org/> for documentation and examples.
  66. ### Disclaimer
  67. 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/).
  68. ### Project
  69. - [Questions & community](https://github.com/pndurette/gTTS/discussions)
  70. - [Changelog](CHANGELOG.rst)
  71. - [Contributing](CONTRIBUTING.rst)
  72. ### Licence
  73. [The MIT License (MIT)](LICENSE) Copyright © 2014-2023 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors)