Skip to main content

gTTS

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’

Metadata

Release files for gTTS 1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gTTS 1.0
File Size Uploaded
gTTS-1.0.tar.gz 3.9 kB Details

Release files / gTTS-1.0.tar.gz

Download URL gTTS-1.0.tar.gz
Size 3.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cd9370057ce2ca79479a134c99f4e581c311a2f5987cd8dc7e7e66f254c276c5
BLAKE2b-256 checksum
How to use checksums
de18c213942210e27166010b9e7a4eb7cbccea6cb69ad3937178c236117be610
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

2.5.4

2 release files

2.5.3

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.0

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.4

1 release file

2.2.3

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.2

2 release files

2.1.1

3 release files

2.1.0

3 release files

2.0.4

3 release files

2.0.3

1 release file

2.0.2

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2.0

1 release file

1.1.8

1 release file

1.1.7

1 release file

1.1.6

1 release file

1.1.5

1 release file

1.1.4

1 release file

1.1.3

1 release file

1.1.2

1 release file

1.0.7

1 release file

1.0.6

1 release file

1.0.5

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

This release

1.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page