Skip to main content

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.

[![Build Status](https://travis-ci.org/pndurette/gTTS.svg?branch=master)](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.

Command line utility

Invoke gtts-cli:

gtts-cli.py –help usage: gtts-cli.py [-h] (-t TEXT | -f FILE) [-l LANG] [–debug] destination

(Ex.) Read the string ‘Hello’ in English to hello.mp3

$ gtts-cli.py -t “Hello” -l ‘en’ hello.mp3

(Ex.) Read the contents of file ‘hello.txt’ in Czech to hello.mp3:

$ gtts-cli.py -f hello.txt -l ‘cs’ hello.mp3

Supported Languages

  • ‘af’ : ‘Afrikaans’
  • ‘sq’ : ‘Albanian’
  • ‘ar’ : ‘Arabic’
  • ‘hy’ : ‘Armenian’
  • ‘ca’ : ‘Catalan’
  • ‘zh-CN’ : ‘Mandarin (simplified)’
  • ‘zh-TW’ : ‘Mandarin (traditional)’
  • ‘hr’ : ‘Croatian’
  • ‘cs’ : ‘Czech’
  • ‘da’ : ‘Danish’
  • ‘nl’ : ‘Dutch’
  • ‘en’ : ‘English’
  • ‘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’
  • ‘ro’ : ‘Romanian’
  • ‘ru’ : ‘Russian’
  • ‘sr’ : ‘Serbian’
  • ‘sk’ : ‘Slovak’
  • ‘es’ : ‘Spanish’
  • ‘sw’ : ‘Swahili’
  • ‘sv’ : ‘Swedish’
  • ‘ta’ : ‘Tamil’
  • ‘th’ : ‘Thai’
  • ‘tr’ : ‘Turkish’
  • ‘vi’ : ‘Vietnamese’
  • ‘cy’ : ‘Welsh’

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gTTS, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size gTTS-1.0.2.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page