Skip to main content

A versatile and user-friendly Python Text-to-Speech engine

Project description


PyPi Version MIT License

A versatile and user-friendly Python Text-to-Speech engine with customizable options.

Table of Contents


You can install the text-to-speech module using pip:

pip install text-to-speech


Basic Usage

You can use this module to convert text to speech and save it as an audio file. Here's a basic example:

from text_to_speech import save

text = "Hello, World!"
language = "en"  # Specify the language (IETF language tag)
output_file = "hello_world.mp3"  # Specify the output file (only accepts .mp3)

save(text, language, file=output_file)


Here are the available parameters for the save function:

Parameter Description Default Value
text The text to be converted to speech.
language The language (IETF language tag) to use for speech synthesis. "en"
slow Set to True if you want the text to be read more slowly. False
file The name of the output audio file. Only accepts .mp3 format. "speech.mp3"
lang_check Set to True to check the text for language errors. False

Example with Slow Speech

You can make the speech slower by setting the slow parameter to True:

from text_to_speech import save

text = "This is a slow speech example."
language = "en"
output_file = "slow_speech.mp3"

save(text, language, slow=True, file=output_file)


Contributions to this project are welcome. If you have any improvements or bug fixes, please submit a pull request.


This project is licensed under the MIT License.

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

text_to_speech-1.6.1.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

text_to_speech-1.6.1-py3-none-any.whl (3.7 kB view hashes)

Uploaded Python 3

Supported by

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