renpy-translator  by anonymousException

Ren'Py game translation tool

Created 2 years ago
253 stars

Top 99.4% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This tool addresses the challenge of translating Ren'Py visual novels by automating the process and supporting multiple translation engines. It benefits game developers and translators by streamlining workflow, extracting untranslated text, and managing translation assets, while also offering advanced features like glossary support and game mod packing.

How It Works

The translator integrates with numerous services (Google, OpenAI, Deepl, etc.) to translate game text extracted from Ren'Py projects. It supports both official Ren'Py extraction methods and its own runtime extraction, capable of handling special symbols and preserving original text as comments. Users can unpack, translate, replace fonts, and repack games into mods, with options for local glossaries and proxy support.

Quick Start & Requirements

Pre-built releases are available for download from the latest release page. Setup requires a Ren'Py game project and a stable network connection for online translation services; VPN/proxy support is included. Key features can be explored via provided video and detailed tutorials.

  • Latest Release: https://github.com/anonymousException/renpy-translator/releases/latest
  • Offline AI Version: https://github.com/anonymousException/renpy-translator/blob/feature/ai-translate/README.md
  • Complete Tutorial: https://github.com/anonymousException/renpy-translator/assets/157234942/1230607c-7313-4ba3-bf3e-ace19efa3c32
  • Video Tutorial: https://github.com/anonymousException/renpy-translator/assets/157234942/6b71c914-8f64-45c4-a1f8-809299b3c8e6

Highlighted Details

  • Supports 108 languages via Google Translation and multiple other engines.
  • Intelligently handles special symbols ({}, [], <>) to prevent translation errors.
  • Extracts untranslated text that official Ren'Py methods might miss.
  • Enables packing translated games into distributable mods using rpatool.
  • Features an "Add Entrance" function to integrate language selection into game preferences.
  • Supports local glossaries for custom terminology and improved translation consistency.
  • Offers font replacement capabilities for translated text.
  • Provides real-time log output for monitoring translation progress.

Maintenance & Community

The README does not detail specific contributors, community channels (like Discord/Slack), or a public roadmap. Information regarding project health and community engagement is not readily available.

Licensing & Compatibility

The project is described as "free and open-source," but a specific license (e.g., MIT, GPL) is not stated. This omission requires clarification for commercial use or integration into proprietary projects.

Limitations & Caveats

Translation accuracy varies by engine and is not guaranteed, often requiring manual review. Special symbols can occasionally be mishandled, necessitating manual fixes. OpenAI usage is restricted for new users and can encounter JSONDecodeError or ConnectError. Extraction may skip very short sentences or those within ConditionSwitch() blocks. Antivirus false positives are noted for Pyinstaller builds.

Health Check
Last Commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
10 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.