Skip to main content

Simple text-to-speech converter with multiple languages and voices

Project description

Text-to-Speech (TTS) Simple (by HMCorp)

This repository provides a simple implementation of a Text-to-Speech (TTS) system. It allows users to generate speech audio files (e.g., .wav) from text input. The project is designed to be lightweight and easy to use.

Features

  • Convert text input into .wav audio files.
  • Cross-platform support for macOS and Windows.
  • Easy setup and usage.

Requirements

  • Python 3.8 or higher
  • pip (Python package manager)

Installation

macOS

  1. Install Python:
    brew install python
    
  2. Clone the repository:
    git clone https://github.com/HMCorp-Fund/tts_simple.git
    cd tts_simple
    
  3. Install dependencies:
    pip install -r requirements.txt
    
  4. Install additional dependencies for .wav file generation:
    brew install ffmpeg
    

Windows

  1. Install Python: Download and install Python from python.org. Ensure you check the box to add Python to your PATH during installation.
  2. Clone the repository:
    git clone https://github.com/yourusername/tts_simple.git
    cd tts_simple
    
  3. Install dependencies:
    pip install -r requirements.txt
    
  4. Install additional dependencies for .wav file generation: Download and install FFmpeg from FFmpeg.org. Add the FFmpeg binary to your system PATH.

Usage

  1. Run the script:

    python tts_simple.py --text "Hello, world!" --output output.wav
    

    Replace "Hello, world!" with your desired text and output.wav with your desired output file name.

  2. Example:

    python tts_simple.py --text "This is a test." --output test.wav
    

Dependencies

The project uses the following Python libraries:

  • gTTS (Google Text-to-Speech)
  • pydub (for audio processing)
  • ffmpeg (for .wav file generation)

Install these dependencies via:

pip install gTTS pydub

Notes

  • Ensure FFmpeg is correctly installed and added to your PATH for .wav file generation.
  • The script is designed for educational purposes and may require additional tuning for production use.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

Contact

For questions or support, please contact [apavlenko@hmcorp.fund].

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

tts_simple-0.1.0.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tts_simple-0.1.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file tts_simple-0.1.0.tar.gz.

File metadata

  • Download URL: tts_simple-0.1.0.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for tts_simple-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9732931e768c53c3eab3b9f7c0fe8085c8afb5cf2c76d21499347ea5f5161c3e
MD5 62491f9c16f5542d6e6e07456cde625a
BLAKE2b-256 5cb8f6563c45b52707010d6d8975aeadfdcfda822eb4de2cbeac1c52ebef1748

See more details on using hashes here.

File details

Details for the file tts_simple-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: tts_simple-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for tts_simple-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 358d80e75e041d40909795fe84b1205b5910fedb324dcfcb018e08cedfe17aee
MD5 1d73c9461b263349cdff560b40753700
BLAKE2b-256 b90c5ca472ede10385e86287b7b5a58c73f2ba578fb7ee4352d2efb8ca245008

See more details on using hashes here.

Supported by

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