Skip to content

Getting Started

Jump to bottom
Ehsan Azish edited this page Dec 15, 2025 · 1 revision

Getting Started

Prerequisites

  • Python 3.7 or higher
  • Internet connection (for Google Translate API)
  • macOS, Linux, or Windows with Tkinter support

Installation

1. Clone the Repository

git clone https://github.com/EhsanAzish80/Auto-Translate-localizables.git
cd Auto-Translate-localizables

2. Install Dependencies

pip3 install -r requirements.txt

The required packages are:

  • deep-translator>=1.11.4 - Google Translate API integration
  • lxml>=4.9.0 - XML/XLIFF handling

3. Verify Installation

Test the installation with a dry run:

python3 translate_xliff.py --dry-run

First Run

Using the GUI (Recommended)

python3 localization_app.py

Using the Command Line

python3 translate_xliff.py --workspace /path/to/your/localization/folder

Expected Folder Structure

Your localization workspace should contain .xcloc folders:

localization/
├── en. xcloc/
│   └── Localizable.xliff
├── de.xcloc/
│   └── Localizable.xliff
├── fr.xcloc/
│   └── Localizable.xliff
└── ...

Next Steps

Clone this wiki locally