Metadata-Version: 2.1
Name: real_time_translator
Version: 0.1.0
Summary: A real-time audio translator using Azure Cognitive Services and PyQt5
Home-page: https://github.com/your-repo/real-time-translator
Author: Your Name
Author-email: your-email@example.com
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: PyQt5
Requires-Dist: pyaudio
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: azure-cognitiveservices-speech

# Real-Time Live Translator with PyQt GUI

This is a real-time live translator application built using Python, PyQt5, and Azure Cognitive Services. The application captures audio from the Windows system speakers using WASAPI loopback, translates the captured audio into a specified language, and displays the translated text in a GUI overlay that stays on top of all applications.

## Features

- **Real-Time Translation**: Captures and translates audio in real-time.
- **Subtitle Overlay**: Displays translated text as subtitles over all applications.
- **Configurable Input/Output Languages**: Users can specify input and output languages.
- **Audio Device Selection**: Users can choose from available audio devices.
- **Configuration Persistence**: Saves user preferences for input/output languages, selected audio device, and Azure settings.
- **Customization Options**: Customize the subtitle overlay's font, color, and appearance.
- **Settings Management**: Reset settings to default, import/export settings.

## Requirements

- `pyenv`
- `pyenv-virtualenv`
- A valid Azure Cognitive Services subscription key and service region.

## Installation

1. **Install `pyenv` and `pyenv-virtualenv`**:

    Follow the instructions [here](https://github.com/pyenv/pyenv#installation) to install `pyenv`.

    Additionally, install `pyenv-virtualenv` by following the instructions [here](https://github.com/pyenv/pyenv-virtualenv#installation).

2. **Clone this repository**:

    ```sh
    git clone https://github.com/yourusername/repo-name.git
    cd repo-name
    ```

3. **Set up a Python version with `pyenv`**:

    Install a specific Python version (e.g., 3.8.10):

    ```sh
    pyenv install 3.8.10
    ```

    Set the local Python version for this project:

    ```sh
    pyenv local 3.8.10
    ```

4. **Create and activate a virtual environment with `pyenv-virtualenv`**:

    Create a virtual environment:

    ```sh
    pyenv virtualenv 3.8.10 translator-env
    ```

    Activate the virtual environment:

    ```sh
    pyenv activate translator-env
    ```

5. **Install the required packages**:

    ```sh
    pip install -r requirements.txt
    ```

    If `requirements.txt` is not provided, you can manually install the dependencies:

    ```sh
    pip install pyaudio numpy scipy azure-cognitiveservices-speech PyQt5
    ```

## Configuration

1. Obtain an Azure Cognitive Services subscription key and service region. You can create a free account [here](https://azure.microsoft.com/en-us/services/cognitive-services/speech-to-text/).

2. Create a `config.json` file with your settings:

    ```json
    {
        "input_language": "en-US",
        "output_language": "es-ES",
        "audio_device_index": 0,
        "subtitle_font": "Arial,24",
        "subtitle_color": "#FFFFFF",
        "azure_subscription_key": "YourAzureSubscriptionKey",
        "azure_region": "YourServiceRegion"
    }
    ```

## Usage

1. Run the application:

    ```sh
    python main.py
    ```

2. Configure the input language, output language, and audio device using the GUI.

3. Click the "Start Translation" button to begin capturing and translating audio.

4. The translated text will be displayed in the GUI and as a subtitle overlay on top of all applications.

5. Click the "Stop Translation" button to stop the translation process.

6. To customize the subtitle overlay, click the "Settings" button and adjust the font, color, and other options as desired.

## Known Issues

- Ensure the correct audio device supporting WASAPI loopback is selected.
- The application currently supports only Windows due to the use of WASAPI for audio capture.

## Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes or improvements.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
