gTTS 1.1.3

Create an mp3 file from spoken text via the Google TTS (Text-to-Speech) API

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

1. Fork [pndurette/gTTS](https://github.com/pndurette/gTTS) on GitHub and clone it locally

2. Make sure you write tests for new features or modify the existing ones if necessary

3. Open a new Pull Request from your feature branch to the develop branch.

4. Thank you!