Create an mp3 file from spoken text via the Google TTS (Text-to-Speech) API
Project description
gTTS (Google Text to Speech): a Python interface to Google’s Text to Speech API. Create an mp3 file with the gTTS module or gtts-cli command line utility. It allows for unlimited lengths of spoken text by tokenizing long sentences where the speech would naturally pause.
[](https://travis-ci.org/pndurette/gTTS)
Install
pip install gTTS
Module
Instanciate:
>> from gtts import gTTS >> tts = gTTS(text=’Hello’, lang=’en’) >> tts.save(“hello.mp3”)
Parameters:
text is the text to speak to file;
lang is the language to speak in. A ISO 639-1 language code supported by the Google Text to Speech API.
Using a file-like object (Ex.):
>> from gtts import gTTS >> from tempfile import TemporaryFile >> tts = gTTS(text=’Hello’, lang=’en’) >> f = TemporaryFile() >> tts.write_to_fp(f) >> f.close()
Command line utility
Invoke gtts-cli:
gtts-cli.py –help usage: gtts-cli.py [-h] ([“text to speak”] | -f FILE) [-l LANG] [–debug] [-o destination_file]
(Ex.) Read the string ‘Hello’ in English to hello.mp3
$ gtts-cli.py “Hello” -l ‘en’ -o hello.mp3
(Ex.) Read the contents of file ‘hello.txt’ in Czech to hello.mp3:
$ gtts-cli.py -f hello.txt -l ‘cs’ -o hello.mp3
Supported Languages
‘af’ : ‘Afrikaans’
‘sq’ : ‘Albanian’
‘ar’ : ‘Arabic’
‘hy’ : ‘Armenian’
‘ca’ : ‘Catalan’
‘zh’ : ‘Chinese’,
‘zh-cn’ : ‘Chinese (Mandarin/China)’
‘zh-tw’ : ‘Chinese (Mandarin/Taiwan)’
‘zh-yue’ : ‘Chinese (Cantonese)’
‘hr’ : ‘Croatian’
‘cs’ : ‘Czech’
‘da’ : ‘Danish’
‘nl’ : ‘Dutch’
‘en’ : ‘English’
‘en-au’ : ‘English (Australia)’
‘en-uk’ : ‘English (United Kingdom)’
‘en-us’ : ‘English (United States)’
‘eo’ : ‘Esperanto’
‘fi’ : ‘Finnish’
‘fr’ : ‘French’
‘de’ : ‘German’
‘el’ : ‘Greek’
‘ht’ : ‘Haitian Creole’
‘hi’ : ‘Hindi’
‘hu’ : ‘Hungarian’
‘is’ : ‘Icelandic’
‘id’ : ‘Indonesian’
‘it’ : ‘Italian’
‘ja’ : ‘Japanese’
‘ko’ : ‘Korean’
‘la’ : ‘Latin’
‘lv’ : ‘Latvian’
‘mk’ : ‘Macedonian’
‘no’ : ‘Norwegian’
‘pl’ : ‘Polish’
‘pt’ : ‘Portuguese’
‘pt-br’ : ‘Portuguese (Brazil)’
‘ro’ : ‘Romanian’
‘ru’ : ‘Russian’
‘sr’ : ‘Serbian’
‘sk’ : ‘Slovak’
‘es’ : ‘Spanish’
‘es-es’ : ‘Spanish (Spain)’
‘es-us’ : ‘Spanish (United States)’
‘sw’ : ‘Swahili’
‘sv’ : ‘Swedish’
‘ta’ : ‘Tamil’
‘th’ : ‘Thai’
‘tr’ : ‘Turkish’
‘vi’ : ‘Vietnamese’
‘cy’ : ‘Welsh’
Contributing
Fork [pndurette/gTTS](https://github.com/pndurette/gTTS) on GitHub and clone it locally
Make sure you write tests for new features or modify the existing ones if necessary
Open a new Pull Request from your feature branch to the develop branch.
Thank you!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file gTTS-1.1.4.tar.gz
.
File metadata
- Download URL: gTTS-1.1.4.tar.gz
- Upload date:
- Size: 6.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
0344f8c0a697d23ba08dec3ab5fbe29046db480d51d4d40f9e1b41f88ce43b2c
|
|
MD5 |
9aa77225b39faf98621e257aecac89f2
|
|
BLAKE2b-256 |
74c183a6fe08b83b50aa7b3be958ca3555cb17bf09a7d2113dff713b997b4f12
|