Metadata-Version: 2.1
Name: kleantrans
Version: 1.0.6
Summary: Clean and translate your highlight text
Author-email: "Cuong. Duong Manh" <cuongpigerr@gmail.com>
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: altgraph>=0.17.4
Requires-Dist: packaging==24.1
Requires-Dist: pyinstaller==6.10.0
Requires-Dist: pyinstaller-hooks-contrib>=2024.8
Requires-Dist: pynput>=1.7.7
Requires-Dist: pyperclip>=1.9.0
Requires-Dist: PyQt6>=6.7.1
Requires-Dist: PyQt6-Qt6>=6.7.2
Requires-Dist: PyQt6-sip>=13.8.0
Requires-Dist: python-xlib>=0.33
Requires-Dist: setuptools>=74.0.0
Requires-Dist: six>=1.16.0

# KleanTrans ![PyPI](https://img.shields.io/pypi/v/kleantrans?label=kleantrans)

_KleanTrans is an open-source application with a clean and simple interface for translating text using PyQT6._

![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)

## Overview
- KleanTrans helps you to clean up the text before translating it, such as remove extra spaces, newlines, and special characters.
- KleanTrans supports translating text from English to Vietnamese and vice versa.
- Do not need to copy and paste the text to the translation tool, just select the text and press `Ctrl + CMD` or **Middle Mouse** to translate the text.

## Pre-requisites

| # | OS               | Python Version | Pass |
|---|------------------|----------------|------|
| 1 | Ubuntu 22.04 LTS | `3.11.x`       | ✅    |
| 2 | Ubuntu 24.04 LTS | `3.12.x`       | ✅    |

- Install the dependencies Ubuntu packages:
  ```bash
  sudo apt update &&
  sudo apt install -y translate-shell xclip libxcb-cursor-dev --upgrade
  ```

- Install required Python packages:
  ```bash
  # Ubuntu 23.04 or higher, Python 3.12 or higher
  pip3 install -r requirements.txt --upgrade --break-system-packages
  
  # Remaining cases
  pip3 install -r requirements.txt --upgrade
  ```

- Install `kleantrans`:
  ```bash
  # Ubuntu 23.04 or higher, Python 3.12 or higher
  pip3 install kleantrans --upgrade --break-system-packages
  
  # Remaining cases
  pip3 install kleantrans --upgrade
  ```

## Demonstration

![](kleantrans.gif)

## Usage:
- Run the application:
  ```bash
  kleantrans
  ```
- Currently, I only support the following languages:
  - English
  - Vietnamese

- To translate text, using mouse to select the text and press `Ctrl + CMD` _(**Window key** on the Windows OS)_ or **Middle Mouse** to translate the text.

- To **SHOW**/**HIDE** the application, press `SHIFT + CMD`.
