Skip to content

README.md

Latest commit

 

History

History
50 lines (33 loc) · 2.33 KB

README.md

File metadata and controls

50 lines (33 loc) · 2.33 KB
Raw

PythonTranslator - Multilingual Translator App

A desktop application built with Python that provides real-time text translation with an intuitive, dynamic user interface. The app features an autocomplete-enabled language selection system and supports UI localization (translating the app's interface into various languages).

Key Features

  • Autocomplete Language Selection: Custom-built combobox widgets with real-time filtering to quickly find source and target languages.
  • Multi-Language Support: Integration with the deep_translator library, supporting a wide range of global languages.
  • Dynamic UI Translation: The application interface itself can be translated into any supported language via the "Translate window" feature.
  • Clean Architecture: Built using CustomTkinter for a modern look and a modular design that separates business logic from the UI.

Project Structure

File Description
main.py The entry point of the application; initializes the GUI.
gui.py Contains the TranslatorApp class and custom UI components (e.g., AutocompleteComboBox).
translator_logic.py Handles the core translation logic using deep_translator and manages the supported language dictionary.

Prerequisites

Ensure you have Python installed on your system. You will also need to install the required dependencies:

pip install customtkinter deep_translator

How to Run

  1. Clone the repository (or download the files).
  2. Navigate to the project folder in your terminal.
  3. Launch the application:
python main.py

How it Works

  • Translation: Select your source and target languages using the autocomplete fields, enter your text in the left textbox, and click the "Translate" button.
  • Interface Localization: Select your preferred application language from the top-right dropdown and click "Translate window." The entire interface (buttons, labels, and placeholders) will automatically update to the selected language using the internal translation engine.

Technical Stack

  • GUI Framework: CustomTkinter (Modern UI for Python).
  • Translation Engine: deep_translator (Google Translate API wrapper).
  • Language Engine: A modular mapping system (languages dictionary) that translates human-readable language names to ISO language codes.