Debian Codegraph @

PKG-INFO

raw
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 [![PyPI version](https://img.shields.io/pypi/v/gTTS.svg)](https://pypi.org/project/gTTS/)
50 [![Python versions](https://img.shields.io/pypi/pyversions/gTTS.svg)](https://pypi.org/project/gTTS/)
51 [![Tests workflow](https://github.com/pndurette/gtts/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/pndurette/gTTS/actions)
52 [![codecov](https://codecov.io/gh/pndurette/gTTS/branch/master/graph/badge.svg)](https://codecov.io/gh/pndurette/gTTS)
53 [![Commits Since](https://img.shields.io/github/commits-since/pndurette/gTTS/latest.svg)](https://github.com/pndurette/gTTS/commits/)
54 [![PyPi Downloads](https://static.pepy.tech/badge/gtts)](http://pepy.tech/project/gtts)
55 [![Buy me a Coffee](https://img.shields.io/badge/buy%20me%20a-coffee-orange)](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)