DeepL Translator GUI

A simple, fast, and elegant cross-platform desktop application for translating text using the DeepL API. Built with Python and pywebview.

This application provides a clean, native-window interface for quick translations, avoiding the need to keep a browser tab open. It securely stores your API key locally and is designed for efficiency.

Features

• Clean & Simple UI: A minimal interface that focuses purely on translation.
• Secure API Key Storage: Your DeepL API key is stored locally in a config.json file and is never tracked by Git.
• First-Run Setup: Automatically prompts for an API key on the first launch.
• Multi-Language Support: Easily switch between target languages (EN, ZH, IT configured by default).
• Auto-Detection: The source language is automatically detected by DeepL.
• Smart UI: The currently detected source language is disabled as a target to prevent redundant translations.
• Convenient Shortcuts:
  • Translate with Ctrl+Enter (or Cmd+Enter on macOS).
  • Automatically translates text on paste.
• One-Click Copy: Easily copy the translated text to your clipboard.
• Cross-Platform: Works on macOS, Windows, and Linux.

Screenshots

Setup View (First Launch)
A clean prompt to enter the DeepL API Key.

Translator View
Main interface showing source text, target language buttons, and translation output.

Installation & Usage

To get started, you will need Python 3 and a DeepL API Key (either Free or Pro).

1. Clone the repository:

   git clone https://github.com/YIN-Renlong/DeepL-Translator-GUI.git
   cd DeepL-Translator-GUI

2. Create a virtual environment and activate it:

   # For macOS / Linux
   python3 -m venv venv
   source venv/bin/activate
   
   # For Windows
   python -m venv venv
   .\venv\Scripts\activate

3. Install the required dependencies:

   pip install -r requirements.txt

4. Run the application:

   python3 app.py

5. First-Time Setup:

   • On the first run, the application will display a setup screen.
   • Enter your DeepL API Key and click "Save and Continue".
   • The app will validate the key. If successful, it will create a config.json file in the project directory to store it securely for future sessions. This file is intentionally ignored by Git.

License

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

---

Coded by YIN Renlong