Skip to main content

Python interface for eSpeak NG

Project description

Some simple wrappers around eSpeak NG intended to make using this excellent TTS for waveform and IPA generation as convenient as possible.

Target audience are developers who would like to use eSpeak NG as-is for speech synthesis in their Python application on GNU/Linux operating systems.

Constructive comments, patches and pull-requests are very welcome.


### Direct TTS Audio Output

First, import the ESpeakNG engine wrapper:

from espeakng import ESpeakNG

now for some simple direct TTS output:

esng = ESpeakNG() esng.say(‘Hello World!’)

lower pitch and speed:

esng.pitch = 32 esng.speed = 150 esng.say(‘Hello World!’)

try a different language:

esng.voice = ‘german’ esng.say(‘Hallo Welt!’)

specify phonemes instead of words:

esng.voice = ‘english-us’ esng.say(“[[h@l’oU w’3:ld]]”)

### Synthesize Wave File without Playing It

>From Text:

import wave import StringIO

esng.voice = ‘english-us’ wavs = esng.synth_wav(‘Hello World!’) wav = print wav.getnchannels(), wav.getframerate(), wav.getnframes()


1 22050 24210

### List Available Voices

l = esng.voices


>>> l[0]
{'pty': '5', 'language': 'af', 'gender': 'M', 'age': '--', 'voice_name': 'afrikaans', 'file': 'gmw/af'}
>>> l[1]
{'pty': '5', 'language': 'am', 'gender': '-', 'age': '--', 'voice_name': 'amharic', 'file': 'sem/am'}
>>> l[2]
{'pty': '5', 'language': 'an', 'gender': 'M', 'age': '--', 'voice_name': 'aragonese', 'file': 'roa/an'}

### Grapheme to Phoneme (G2P) Conversion

ipa = esng.g2p (‘Hello World!’, ipa=2)


>>> print ipa
həlˈo͡ʊ wˈɜːld


  • Python 2 or 3
  • espeak-ng binary installed and in PATH


My own code is Apache-2.0 licensed unless otherwise noted in the script’s copyright headers.


Guenter Bartsch <<>>

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 py-espeak-ng, version 0.1.8
Filename, size File type Python version Upload date Hashes
Filename, size py_espeak_ng-0.1.8-py2.py3-none-any.whl (6.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size py-espeak-ng-0.1.8.tar.gz (11.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page