ArtexTTS 0.0.2

A python text to speech library

Text to Speech (TTS) Project

This project leverages Selenium and webdriver_manager to utilize Chrome's built-in text-to-speech feature. It's designed for simplicity and ease of use, allowing you to configure continuous text-to-speech functionality and optional English translation.

Features

• Continuous Text-to-Speech: Decide if you want the text-to-speech functionality to run continuously.
• Optional English Translation: Choose whether to translate text to English before speaking.
• Easy Configuration: Simple setup using two text files.

Prerequisites

• Selenium
• webdriver_manager

Setup

1. Install dependencies:

   pip install selenium webdriver_manager
   

2. Create Configuration Files:

   • input_sentence_file.txt: This file will contain the sentences that need to be spoken.
   • stop_or_not_file.txt: This file will control whether the text-to-speech function continues to check the input text file for new sentences. It should contain either "A" or "B".
     • "A" means the function will continue to work.
     • "B" means the function will stop.

Usage

To use the text-to-speech functionality, import the Speaker class from ArtexTTS and initialize it with the appropriate parameters.

from ArtexTTS import Speaker

ai = Speaker(
    input_file_path="input_sentence_file.txt",
    stop_file_path="stop_or_not_file.txt",
    translate=True | False,
    speak_continous=True | False
)

ai.speak()

Parameters

• input_file_path (str): Path to the file containing sentences to be spoken.
• stop_file_path (str): Path to the file that controls whether to stop or continue.
• translate (bool): Set to True to translate the text to English before speaking, False otherwise.
• speak_continous (bool): Set to True for continuous text-to-speech, False for single execution.

Continuous Usage

If you want the text-to-speech functionality to run continuously, it is recommended to use threading. This will prevent the function from blocking the execution of further code until it is stopped.

Example with Threading

import threading
from ArtexTTS import Speaker

def tts_thread():
    ai = Speaker(
        input_file_path="input_sentence_file.txt",
        stop_file_path="stop_or_not_file.txt",
        translate=True,
        speak_continous=True
    )
    ai.speak()

# Start TTS in a separate thread
thread = threading.Thread(target=tts_thread)
thread.start()
thread.join()

To make the program speak, update the sentence in input_sentence_file.txt. To stop the function, change the value in stop_or_not_file.txt from "A" to "B".

This project is managed by Artex AI. Soon an improved and stable version will roll out