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.

Module

Initialize a new GoogleTTS:

>> 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 –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 -t “Hello” -l ‘en’ hello.mp3

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

$ gtts-cli -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.

Source Distribution

gTTS-1.0.tar.gz (3.9 kB view details)

Uploaded Source

File details

Details for the file gTTS-1.0.tar.gz.

File metadata

  • Download URL: gTTS-1.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for gTTS-1.0.tar.gz
Algorithm Hash digest
SHA256 cd9370057ce2ca79479a134c99f4e581c311a2f5987cd8dc7e7e66f254c276c5
MD5 6bf9a468c6374dcd8b8f8d6a10b992f4
BLAKE2b-256 de18c213942210e27166010b9e7a4eb7cbccea6cb69ad3937178c236117be610

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page