Skip to content

thanhkeke97/RSTGameTranslation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ RSTGameTranslation

Real-time Screen Translation for Gaming

Version License Platform

Translate your games in real-time with AI-powered OCR and LLM technology

๐Ÿ“ฅ Download โ€ข ๐Ÿ“– Vietnamese Guide โ€ข ๐Ÿ› Report Bug


โœจ Features

๐Ÿ”ฅ Real-time Translation

  • Live automatic translations using EasyOCR, PaddleOCR and Windows OCR
  • Powerful overlay chat window for visual novels
  • Full-screen translation capability
  • Can display translated text overlaid on the original text in the selected area (Hotkey Alt+F, only work win 11)

๐Ÿค– AI-Powered Translation

  • Support for multiple LLMs: Gemini, ChatGPT, Ollama, Mistral
  • Google Translate integration
  • Context-aware translations for better accuracy

๐ŸŽฏ Smart Recognition

  • Game-specific translation optimization
  • Previous context consideration
  • Character and location name recognition

๐Ÿ”Š Additional Features

  • Text-to-speech functionality
  • 100% local translation option with Ollama

Preview

๐Ÿš€ Quick Start

Prerequisites

  • Windows 10+ and (Required)
  • Windows 11 for display translated text overlaid on the original text feature (Optional)
  • NVIDIA GPU (Recommended for best performance, Optional)
  • Game in windowed/borderless mode (Required)

Installation

  1. Download the latest version from Releases
  2. Extract the zip file to your desired location
  3. Install Conda For the Conda installation guide, follow this link (See on Installation and Usage)

Setup Guide

๐Ÿ“‹ Step-by-step Setup

1. Initial Configuration

  • Run RSTGameTranslation/rst.exe
  • Go to Settings โ†’ OCR tab: Choose OCR method
  • Go to Settings โ†’ Language tab: Choose source and target languages (If you are using Windows OCR, please click the "Check" button to verify the language pack before starting)
  • Go to Settings โ†’ Translation tab: Select your preferred translation service

2. Server Setup (One-time)

  • Click SetupServer button (Skip if using Windows OCR)
  • Wait 5-15 minutes for setup completion
  • Look for "environment setup completed" message

3. Start Translating

  • Click StartServer and wait for connection confirmation (Skip if using Windows OCR)
  • Select translate area (ALT+Q or Click on SelectArea button)
  • Click Start button (ALT+G) to begin translation
  • View results in ChatBox or Monitor window

4. LLM Configuration

  • Add your Gemini API key in settings (You can enter multiple API keys, press Enter after entering each API key)
  • Configure game name for better context (context tab)
  • Adjust other settings as needed

โŒจ๏ธ Keyboard Shortcuts

Shortcut Function Note
Alt + G Start/Stop Works globally
Alt + Q Select Translation Area Works globally
Alt + F Show/Hide Monitor Overlay Works globally
Alt + C Show/Hide ChatBox Works globally
Alt + P Show/Hide Settings Works globally
Alt + L Show/Hide Log Console Works globally

๐Ÿ”„ Updates

RSTGameTranslation automatically checks for updates on startup. When available:

  1. Download from notification or Releases page
  2. Close the application
  3. Extract new files over existing installation
  4. Restart - your settings are preserved!

โš™๏ธ Advanced Configuration

Recommended Setup

  • OCR: PaddleOCR (Better for Asian languages, lower resource usage)
  • LLM: Gemini Flash 2 Lite (Fast and accurate)
  • NVIDIA: PaddleOCR or EasyOCR
  • AMD, INTEL: Windows OCR

Alternative Options

  • Windows OCR: Lightweight but less accurate for gaming
  • Ollama: 100% local translation (RTX 4090: ~5s per translation)
  • ChatGPT: GPT-4.1 Nano for premium results

Performance Tips

  • Smaller translation areas = faster processing
  • NVIDIA GPU highly recommended
  • First-time language downloads may take 1-2 minutes
  • The application will automatically change API keys if the previous API is rate-limited, so please enter as many API keys as possible
  • The translation speed depends on the LLM model; if you are using Gemini, you should check the translation speed at here

๐Ÿ› ๏ธ For Developers

Compilation

  • Open solution in Visual Studio 2022
  • Click compile (dependencies should auto-download)

Python Server Development

  • Use VSCode for development/debugging
  • Built on EasyOCR and PaddleOCR foundations

โš ๏ธ Important Notes

Privacy: Only checks GitHub for version updates. Cloud translation services (Gemini, ChatGPT) will see translated content. Ollama keeps everything local.

Performance: CPU-only mode will use 30-50% CPU power. Dedicated NVIDIA GPU strongly recommended.


๐Ÿ’ฌ Community

Join our Discord community for support, discussions, and updates:

Discord

Get help from other users, share your experiences, and stay updated on the latest developments!


๐Ÿ“„ License

This project is licensed under BSD-style attribution - see LICENSE.md for details.

Acknowledgments: This product includes software developed by Seth A. Robinson - UGTLive


Made with โค๏ธ for the gaming community

โญ Star this project if you find it helpful!