neavo/LinguaGacha

Next-generation text translator utilizing AI capabilities for one-click translation of novels, games, subtitles, and more

   

README 🌍

• [ 中文 ] | [ English ] | [ 日本語 ] | [ 한국어 ] | [ Deutsch ]

Overview 📢

• LinguaGacha (/ˈlɪŋɡwə ˈɡɑːtʃə/), is an AI-powered next-generation text translator
• Out of the box, (almost) no setup needed, powerful does not need to be shown through complicated options
• Supports one-click translation between 16 languages
  • including Chinese, English, Japanese, Korean, Russian, German, French, Italian, etc
• Supports various text types and formats such as Subtitle, E-Book, and Game Text
• Supports both local and online interfaces compatible with OpenAI, Google, Anthropic, SakuraLLM

Special Notice ⚠️

• If you use LinguaGacha during translation, please include clear attribution in prominent locations of your work's information or release pages!
• For projects involving commercial activities or profits, please contact the author for authorization before using LinguaGacha!

Feature Advantages 📌

• Optimal translation quality and the fastest translation speed
  • Fully preserves the styles of various Subtitles and E-books
  • Automatically generates a glossary to keep proper nouns consistent throughout the work
  • Subtitles in ten seconds, a novel in one minute, a game in five minutes
• Built-in AGENT mode that automatically completes various tasks through conversation 👈👈 Exclusive Feature
  • No technical knowledge required: translate and play
  • Covers all major engines: Godot RenPy Tyrano WOLFRPG RPGMAKER Kirikiri Unity Bakin RealLive Escude ACTION GAME MAKER

Basic Workflow 🛸

• Download application from Releases page
  • Windows:
    • Download *_Windows_x64.zip or *_Windows_arm64.zip according to your CPU type
    • Extract it and double-click app.exe to launch
  • macOS:

    - Download `*_macOS_x64.dmg` or `*_macOS_arm64.dmg` according to your CPU type - Drag it to the Applications folder, but do not launch it yet - Open Terminal, enter `sudo xattr -rd com.apple.quarantine /Applications/LinguaGacha.app`, then press Enter - Enter your system password, close Terminal, and you can launch it normally
  • Linux:

    - Download `*_Linux_x64.AppImage` or `*_Linux_arm64.AppImage` according to your CPU type - Add executable permission with `chmod +x LinguaGacha*.AppImage` - Run `./LinguaGacha*.AppImage`
• Obtain a reliable AI model interface. Recommended:
  • [ DeepSeek API ] (No GPU required)
• Launch the application, drag the files to translate onto the page, and press Enter!

User Guide 📝

• Getting Started
  • Basic Tutorial　👈 Step-by-step tutorial, easy to follow, a must-read for beginners
  • File Format Support
• Model Setup
  • Model Management　　DeepSeek
• Feature Description
  • AGENT　　Proofreading
  • Glossary　　Text Preserve　　Text Replacement
  • MTool Optimizer　　CLI Mode　　Advanced Features
• Engine Best Practices
  • Best Practices for High-Quality Translation of Godot Engine Games
  • Best Practices for High-Quality Translation of RenPy Engine Games
  • Best Practices for High-Quality Translation of Tyrano Engine Games
  • Best Practices for High-Quality Translation of WOLFRPG Engine Games
  • Best Practices for High-Quality Translation of RPGMAKER Engine Games
• Community Notes
  • Machine Translation Notes for Kirikiri Engine Games Without Complex Encryption
• You can find more details on each feature in the Wiki

Supported Formats 🏷️

Type	Format	Notes
Subtitles	.srt .ass .ssa .vtt .lrc	-
E-books	.txt .pdf .epub	-
Markdown	.md	-
KV-JSON game text	.json	Source: [MTool] [SExtractor]
Message-JSON game text	.json	Source: [SExtractor] [VNTextPatch]
Godot game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of Godot Games]
RenPy game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of RenPy Games]
Tyrano game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of Tyrano Games]
WOLFRPG game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of WOLFRPG Games]
RPGMAKER MV/MZ game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of RPGMAKER Games]
RPGMAKER XP/VX/VXAce game files	.exe or game directory	Guide: [Best Practices for High-Quality Translation of RPGMAKER Games]
.rpy game text	.rpy	👈 Support ending soon
.xlsx game text	.xlsx	Source: SExtractor Translator++ WOLF Official Translation Tool　👈 Support ending soon
.trans project files	.trans	Source: Translator++　👈 Support ending soon
Games subtitles e-books in other formats	Any	Identified and processed by AGENT automatically

Recent Updates 📅

• 20261105 v0.140.0
  • An all-new Native Harness version
  • Supports in theory all games, subtitles, and e-books
  • Learns on its own, automatically recording experience from each localization project and becoming more proficient over time
  • Can be used independently for everyday tasks as a full-featured AGENT tool with unrestricted output

Development Guide 🛠️

• Install Go and Node.js
• Install dependencies npm install
• Update dependencies npm ci
• Run the application npm run dev
• Build the release npm run build
• Before submitting a PR, run the corresponding checks in docs/WORKFLOW.md based on the scope of your changes
• For non-developers, please download the packaged version directly from the Releases page

Support 😥

• Runtime logs are stored in log folder
• Please attach relevant logs when reporting issues
• You can also join our groups for discussion and feedback:
  • Discord - https://discord.gg/pyMRBGse75