ease-tts 3.1.0

Lightweight Python module for converting text into natural-sounding speech on Windows, macOS and Linux.

Python TTS

Ease-TTS is a simple and lightweight Python module for converting text into speech. It supports playback on Windows, macOS, and Linux. Easy to install and beginner-friendly, it is ideal for accessibility, automation, learning projects, or adding natural voice output to applications.

Prerequisites

• Python 3.9+
• An audio player:
  • Windows → Uses default media player
  • macOS → Uses afplay
  • Linux → Requires mpg123 (sudo apt install mpg123)

Setup

You can clone the repo and install dependencies in one go:

git clone https://github.com/Madhav703/ease-tts.git
cd ease-tts
pip install -r requirements.txt

Or install directly from PyPI:

pip install ease-tts

Usage

from ease_tts import TTS

m = TTS()
m.play("Hello World")

This will generate speech and play Hello World on your system.

Notes

• Requires an active internet connection (gTTS sends text to Google Translate TTS).
• On Linux, ensure mpg123 is installed for playback (system usage).
• For Discord usage, ensure you have FFmpeg installed and available in PATH.
• Temporary files are automatically cleaned up after playback.

Troubleshooting

• gtts.tts.gTTSError → check your internet connection.
• FileNotFoundError: [Errno 2] No such file or directory: 'mpg123' → install mpg123 on Linux.
• ffmpeg not found → install FFmpeg for Discord voice support.
• Audio not playing on Windows (system usage) → check if your system has a default MP3 player set.

Contributing

• Fork this repository and make your changes.
• Test the module to ensure everything works.
• Submit a pull request with a clear description.

License

• This project is licensed under the MIT License – see the LICENSE file for details.

Facing any Issues?

• You can open an issue on the GitHub repo.