webui-msword-Azure-tts

This project is a simple web application that converts Microsoft Word (.docx and .doc), plain text (.txt) and text-based PDF (.pdf) files to MP3 format using Azure Text-to-Speech services.

Features

• Upload a Microsoft Word (.docx) file
• Choose a language and voice for the Text-to-Speech conversion
• Listen to the converted MP3 file
• Download the converted MP3 file
• Delete the converted MP3 file and the original .docx file from the server

Installation

1. Clone the repository:

git clone https://github.com/lancer1911/webui-msword-Azure-tts.git

2. Change into the project directory:

cd webui-msword-Azure-tts

3. Install the required dependencies:

pip install -r requirements.txt

4. Install ffmpeg:

• On Windows:

  • Download the static build from the ffmpeg download page.
  • Unzip the downloaded file and remember the location where you extracted it.
  • Add the bin folder under the extracted location to your environment variable Path.
  • To test the installation, open a new command prompt and type ffmpeg -version. If it was installed properly, it should display the version information.

• On macOS:

  • If you have homebrew installed, you can install ffmpeg using the following command:

  brew install ffmpeg
  

  • To test the installation, open a terminal and type ffmpeg -version. If it was installed properly, it should display the version information.

• On Linux:

  • You can install ffmpeg using the package manager of your distro. For Ubuntu, you can use the following command:

  sudo apt install ffmpeg
  

  • To test the installation, open a terminal and type ffmpeg -version. If it was installed properly, it should display the version information.

Usage

Start the Flask application

python app.py

Or, start the application with uWSGI

1. Install uWSGI:

pip install uwsgi

2. Run uWSGI:

uwsgi --ini uwsgi.ini

Open your web browser and navigate to http://localhost:5321 to access the application.

3. Azure subscription key and the Region for the Azure Text-to-Speech service are needed. Follow the instructions at BobTranslate to obtain an API key.

Technologies

• Python
• Flask web framework
• Azure Cognitive Services Text-to-Speech API
• HTML, CSS, and JavaScript for frontend

Docker Version

This repository contains a Flask-based web application that provides an interface for converting Microsoft Word documents into speech using Azure Cognitive Services Text-to-Speech API. The application is designed to run inside a Docker container, making it easy to deploy and manage.

Features

• Upload Microsoft Word documents (.docx)
• Convert the text within the Word document to speech using Azure Cognitive Services Text-to-Speech API
• Serve the generated audio file for playback or download
• Input Azure Speech Services API key and region directly through the web interface

Prerequisites

• Docker installed on your machine
• An Azure account with an active subscription
• ffmpeg installed on your machine

How to use

Docker Hub Repository

https://hub.docker.com/r/lancer1911/webui-msword-azure-tts

1. Pull the Docker image

Pull the Docker image using the following command:

docker pull lancer1911/webui-msword-azure-tts

2. Run the Docker container

Run the Docker container using the following command:

docker run -d -p 5321:5321 --name webui-msword-azure-tts-container lancer1911/webui-msword-azure-tts

3. Access the web application

Open a web browser and visit http://<IP address of your server>:5321 to access the web application. You will be prompted to enter your Azure Speech Services API key and region through the web interface.

Or, build your own Docker

1. Clone the repository

Clone this repository to your local machine using the following command:

git clone https://github.com/lancer1911/webui-msword-azure-tts.git

2. Build the Docker image

Navigate to the root of the repository and build the Docker image using the following command:

docker build -t webui-msword-azure-tts .

or under MacOS, using the following command (otherwise, it may build for the linux/arm64/v8 platform):

docker buildx build --platform linux/amd64 -t webui-msword-azure-tts .

3. Run the Docker container

Run the Docker container using the following command:

docker run -d -p 5321:5321 --name webui-msword-azure-tts-container webui-msword-azure-tts

4. Access the web application

Open a web browser and visit http://localhost:5321 to access the web application. You will be prompted to enter your Azure Speech Services API key and region through the web interface.

Support

If you encounter any issues or have questions, please open an issue on the GitHub repository.

License

This project is licensed under the MIT License.