Skip to content

nateshmbhat/pyttsx3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Offline Text To Speech (TTS) converter for Python

Downloads Downloads

pyttsx3 is a text-to-speech conversion library in Python. Unlike alternative libraries, it works offline.

Buy me a coffee ๐Ÿ˜‡Buy me a coffee ๐Ÿ˜‡

Installation :

pip install pyttsx3

If you get installation errors , make sure you first upgrade your wheel version using : pip install --upgrade wheel

Features :

  • โœจFully OFFLINE text to speech conversion
  • ๐ŸŽˆ Choose among different voices installed in your system
  • ๐ŸŽ› Control speed/rate of speech
  • ๐ŸŽš Tweak Volume
  • ๐Ÿ“€ Save the speech audio as a file
  • โค๏ธ Simple, powerful, & intuitive API

Linux installation requirements :

  • If you are on a Linux system and if the voice output is not working, then :

    Install espeak-ng and libespeak1 as shown below:

     sudo apt update && sudo apt install espeak-ng libespeak1
    

Usage :

import pyttsx3
engine = pyttsx3.init()

# For Mac, If you face error related to "pyobjc" when running the `init()` method :
# Install 9.0.1 version of pyobjc : "pip install pyobjc>=9.0.1"

engine.say("I will speak this text")
engine.runAndWait()

Single line usage with speak function with default options

import pyttsx3
pyttsx3.speak("I will speak this text")

Changing Voice , Rate and Volume :

import pyttsx3
engine = pyttsx3.init() # object creation

# RATE
rate = engine.getProperty('rate')   # getting details of current speaking rate
print (rate)                        # printing current voice rate
engine.setProperty('rate', 125)     # setting up new voice rate

# VOLUME
volume = engine.getProperty('volume')   # getting to know current volume level (min=0 and max=1)
print (volume)                          # printing current volume level
engine.setProperty('volume',1.0)        # setting up volume level  between 0 and 1

# VOICE
voices = engine.getProperty('voices')       # getting details of current voice
#engine.setProperty('voice', voices[0].id)  # changing index, changes voices. o for male
engine.setProperty('voice', voices[1].id)   # changing index, changes voices. 1 for female

engine.say("Hello World!")
engine.say('My current speaking rate is ' + str(rate))
engine.runAndWait()
engine.stop()

# Saving Voice to a file
# On Linux, make sure that 'espeak-ng' is installed
engine.save_to_file('Hello World', 'test.mp3')
engine.runAndWait()

Full documentation of the Library

https://pyttsx3.readthedocs.io

Included Text-To-Speech Engines by Operating System

Linux macOS Windows
AVSpeech โœ…๏ธŽ
eSpeak โœ…๏ธŽ โœ…๏ธŽ โœ…๏ธŽ
NSSpeechSynthesizer โœ…๏ธŽ
SAPI5 โœ…๏ธŽ

Note

  • AVSpeechSynthesizer support is still experimental.
  • NSSpeechSynthesizer is deprecated by Apple.

Feel free to wrap another text-to-speech engine for use with pyttsx3.

Project Links :