glotext 0.1.0

A CLI tool to translate PDFs documents into another languages.

Adapter

A robust Python tool to translate PDF documents while preserving their original structure, including tables and formatting. It extracts text and tables intelligently, translates them using Google Translate, and rebuilds the document as a clean PDF.

Features

• Structure Preservation: Maintains the reading order of text and tables (unlike simple extractors).
• Table Support: Detects and translates table contents cell-by-cell.
• Multi-language: Supports translation between any languages supported by Google Translate.
• RTL Support: Automatically handles Right-to-Left languages like Urdu, Arabic, Persian, etc., with appropriate fonts.

Installation

You can install this package via pip (after building or if published):

pip install adapter

Or install from source:

git clone https://github.com/muhammad-asif10/adapter_cli.git
cd adapter
pip install .

Important: Install Playwright Browsers

This tool uses Playwright for high-quality PDF rendering. You must install the necessary browsers after installing the package:

playwright install chromium

Usage

CLI

You can use the command line interface adapter

adapter input.pdf output.pdf --source-lang english --target-lang urdu

Options:

• input_pdf: Path to the source PDF file.
• output_pdf: Path where the translated PDF will be saved.
• -sl, --source-lang: Source language code or name (default: "english").
• -tl, --target-lang: Target language code or name (default: "urdu").
• --max-pages: (Optional) Limit the number of pages to process.

Python API

You can also use it as a library in your Python scripts:

from adapter import process_pdf

process_pdf(
    input_pdf="document.pdf",
    output_pdf="document_translated.pdf",
    source_lang="english",
    target_lang="spanish",
    max_pages=5
)

Requirements

• Python 3.10+
• pymupdf
• pdfplumber
• deep-translator
• playwright

License

MIT License