Translate Your Ren'Py Games Effortlessly

A powerful and easy-to-use GUI tool for translating Ren'Py Visual Novels automatically. Supports .rpy files and .rpa packages with LibreTranslate integration.

Download Latest View on GitHub
Ren'Py Translator GUI Application Interface showing translation workflow

Powerful Features

Everything you need to localize your Visual Novels efficiently and professionally.

.rpy File Support

Automatically scans and translates all Ren'Py script files (.rpy) in your project with intelligent dialogue detection.

.rpa Package Translation

Apply translations directly to packaged .rpa game files. Re-translate and repackage with ease.

LibreTranslate Integration

Uses LibreTranslate API for free and open-source translation. No API keys required, fully self-hosted.

Auto-Dialogue Detection

Smart detection of translatable dialogue lines. Automatically identifies what to translate and what to keep as code.

Proper Folder Structure

Automatically generates the correct game/tl/<language>/ directory structure for seamless Ren'Py integration.

Clean PySide6 GUI

Modern, intuitive graphical interface built with PySide6. Simple workflow: select, scan, translate, done.

How It Works

Six simple steps to translate your Visual Novel.

1

Select Project Folder

Choose your Ren'Py project directory or packaged .rpa file through the intuitive file browser.

2

Automatic Scanning

The tool quickly scans all .rpy script files and identifies all translatable dialogue lines.

3

Dialogue Detection

Advanced parsing separates code from translatable content, preserving game logic.

4

Translation Process

Each dialogue line is sent to LibreTranslate and converted to your target language.

5

Generate Structure

Creates the proper game/tl/<language>/ folder with correctly formatted translation files.

6

Apply to Package

Optionally re-apply translations to a packaged .rpa file for instant localized game.

Technical Specifications

Built with modern, reliable technologies.

Core Technologies

  • Python 3.8+ - Robust, cross-platform backend
  • PySide6 - Modern Qt-based GUI framework
  • LibreTranslate - Free and open translation API
  • MIT License - Fully open source

Supported Features

  • Classic Ren'Py Projects - Standard project structure
  • .rpa Package Files - Extract, translate, repackage
  • Multi-language - Any language supported by LibreTranslate
  • Cross-Platform - Windows, macOS, Linux

Installation

Get started in minutes with these simple steps.

terminal 
# Clone the repository
git clone https://github.com/AnwarAllal23/renpy-translator-gui.git
cd renpy-translator-gui

# Create virtual environment
python -m venv .venv

# Activate on Windows
..venv\Scripts\activate

# Activate on macOS / Linux
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python main.py