https://github.com/nateshmbhat/pyttsx3
Offline Text To Speech synthesis for python
https://github.com/nateshmbhat/pyttsx3
python python3 pyttsx pyttsx3 text-to-speech text-to-speech-python3
Last synced: 9 days ago
JSON representation
Offline Text To Speech synthesis for python
- Host: GitHub
- URL: https://github.com/nateshmbhat/pyttsx3
- Owner: nateshmbhat
- License: mpl-2.0
- Created: 2017-06-24T12:20:26.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-01-05T10:25:55.000Z (9 months ago)
- Last Synced: 2025-05-12T00:36:44.893Z (5 months ago)
- Topics: python, python3, pyttsx, pyttsx3, text-to-speech, text-to-speech-python3
- Language: Python
- Homepage:
- Size: 351 KB
- Stars: 2,321
- Watchers: 40
- Forks: 350
- Open Issues: 73
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: docs/support.rst
Awesome Lists containing this project
- awesome-free-tts - pyttsx3 - Cross-platform text-to-speech library for Python. BSD 3-Clause License, works offline. (Open Source TTS Libraries / Python Libraries)
- awesome-free-tts - pyttsx3 - Cross-platform text-to-speech library for Python. BSD 3-Clause License, works offline. (Open Source TTS Libraries / Python Libraries)
README
Offline Text To Speech (TTS) converter for Python
[](https://pepy.tech/project/pyttsx3)  [](https://github.com/nateshmbhat/pyttsx3) [](https://github.com/nateshmbhat/pyttsx3) [](https://pypi.org/project/pyttsx3/) [](https://github.com/nateshmbhat/pyttsx3) [](https://github.com/nateshmbhat)
`pyttsx3` is a text-to-speech conversion library in Python. Unlike alternative libraries, **it works offline**.
## 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 :
```python3
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**
```python3
import pyttsx3
pyttsx3.speak("I will speak this text")
```
**Changing Voice , Rate and Volume :**
```python3
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.
[AVSpeech]: https://developer.apple.com/documentation/avfoundation/speech_synthesis
[eSpeak]: https://github.com/espeak-ng/espeak-ng?tab=readme-ov-file#readme
[NSSpeechSynthesizer]: https://developer.apple.com/documentation/appkit/nsspeechsynthesizer
[SAPI5]: https://learn.microsoft.com/en-us/previous-versions/windows/desktop/ms723627(v=vs.85)
Feel free to wrap another text-to-speech engine for use with ``pyttsx3``.
### Project Links :
* PyPI (https://pypi.org/project/pyttsx3)
* GitHub (https://github.com/nateshmbhat/pyttsx3)
* Full Documentation (https://pyttsx3.readthedocs.org)
