Skip to content
View toyakyo's full-sized avatar

Block or report toyakyo

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please donโ€™t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
toyakyo/README.md

๐ŸŽฎ LangForge

AI-Powered Game Screenshot Translation Tool for Windows

Capture your game screen ยท AI translates the text ยท Result overlays directly on the image
Play any foreign-language game. Read everything. No interruptions.

Version Platform Open Source Ko-fi Patreon

๐Ÿ“ฅ Download โ€ข ๐Ÿ“– Documentation โ€ข ๐Ÿ’ฌ Community โ€ข โ˜• Ko-fi โ€ข ๐Ÿ’œ Patreon


๐ŸŒŸ What is LangForge?

LangForge is an open-source AI-assisted game translation tool for Windows. It automatically detects your game window, captures the screen, and translates on-screen foreign text using your choice of AI engine โ€” overlaying the result directly on the screenshot, positioned where the original text was.

Designed for players who want to enjoy Japanese, Korean, or any foreign-language game without switching windows or pausing to look things up.

โš ๏ธ LangForge is under active development. Features and UI may change between versions.


๐Ÿ”ฅ Three Translation Modes

๐Ÿ” Local OCR + Google Translate โ€” Zero Setup, Zero Cost

No API key. No account. No configuration whatsoever.
LangForge uses EasyOCR locally to detect and position text, then routes through Google Translate (free, no quota limits) for the actual translation.
โ†’ Best for: first-time users, or anyone who doesn't want to create API accounts.

๐Ÿฆ™ OLLAMA Local Engine โ€” Full Offline AI

Runs entirely on your own machine. No internet after setup, no API costs, no data leaves your device.
Requires installing OLLAMA and a vision-capable model (e.g. llava). A dedicated GPU is recommended.
โ†’ Best for: privacy-focused users with decent hardware.

โ˜๏ธ Cloud Engines โ€” Best Translation Quality

Supports 10 mainstream AI engines including Gemini, Groq, Mistral (free tiers available) and OpenAI, Claude, Grok, HuggingFace, Together AI, Cerebras, NVIDIA NIM.
LangForge automatically rotates engines when a free quota runs out โ€” keeping translation running uninterrupted.
โ†’ Best for: users who want the highest translation accuracy.


โœจ Features

Feature Description
๐Ÿ–ผ๏ธ Overlay Translation Translated text positioned directly on the game screenshot
๐ŸŒ Multi-Language Output Japanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
๐Ÿ“ Horizontal / Vertical Layout Supports both Western (Lโ†’R) and Japanese-style (topโ†’bottom, Rโ†’L) text direction
๐Ÿ”ค Auto Font Matching Overlay font auto-selected based on target language (JP, KR, RU, etc.)
๐Ÿ“‹ AI Walkthrough Analysis 3โ€“5 actionable hints based on the current game screen
โšก Auto-Capture Detects scene stability and triggers translation automatically
โŒจ๏ธ Global Hotkeys Trigger translation or walkthrough without leaving your game
๐ŸŽฌ Session Recording Records your play session with playback and live delay mode
๐Ÿ—‚๏ธ Translation History SQLite-backed records with screenshot, organized by game and platform
๐Ÿ” Encrypted API Keys Keys encrypted with your machine ID (XOR + base64) before saving locally
๐Ÿ–ฑ๏ธ Click-to-Select Window Click directly on your game window to set it as target
๐Ÿ“Ÿ Simple Mode (Tab 7) Streamlined local-engine interface โ€” pick your OLLAMA model and translate instantly
๐ŸŒ— Dark / Light Theme Toggle UI theme from the View menu
๐ŸŒ Bilingual UI Supports ็น้ซ”ไธญๆ–‡ and English, toggle anytime from the menu
๐Ÿ”„ Auto Engine Rotation Automatically switches to the next available engine when free quota runs out
๐Ÿ“Š Quota Dashboard Real-time view of today's usage per model, with RPM and RPD tracking
๐Ÿ› ๏ธ Platform Editor Add, rename, or remove game platforms and emulators directly in the UI
๐Ÿ”€ One-Click Mode Switch Toggle between Advanced and Simple Mode instantly from the menu bar

๐Ÿš€ Getting Started

Option A โ€” Zero Setup (Recommended for First-Time Users)

  1. Download and run LangForge.exe
  2. Select ๐Ÿ” Local OCR + Google Translate as your engine
  3. Set your target game window title in the Capture tab
  4. Click Capture & Translate โ€” done!

No API key needed. No account required.

Option B โ€” Cloud Engine (Best Quality, Free)

  1. Get a free Gemini API Key from aistudio.google.com (Google account required, no credit card)
  2. Run LangForge, select โ˜ Cloud Engine โ†’ Gemini
  3. Paste your key and start translating

For maximum free quota, also set up Groq, Mistral, Together AI and Cerebras โ€” LangForge rotates them automatically.

Option C โ€” Fully Offline (OLLAMA)

  1. Install OLLAMA
  2. Run ollama pull llava to download a vision model
  3. Start with ollama serve
  4. In LangForge, select ๐Ÿฆ™ Local Engine (OLLAMA)

New in V1.5: Use Simple Mode (Tab 7) for a streamlined OLLAMA experience โ€” no API key, minimal setup.

Option D โ€” Running from Source

git clone https://github.com/toyakyo/LangForge.git
cd LangForge
pip install anthropic easyocr google-genai groq keyboard mistralai numpy openai pillow pywin32
python LangForge.py

๐Ÿ“‹ Supported AI Engines

Engine Recommended Model Free Daily Quota Notes
Gemini gemini-3-flash 500 RPD New-gen Flash, recommended
Gemini gemini-2.5-flash 20 RPD Stable, strong vision
Groq qwen/qwen3.6-27b 1,000 RPD Multimodal, fast
Mistral mistral-small-latest 500 RPD Vision support
HuggingFace Llama-3.2-11B-Vision Free tier Open-source vision models
Together AI Llama-Vision-Free Unlimited (free) Permanently free vision model
Cerebras gemma-4-31b ~2,100 RPD 1,800+ tok/s, ultra fast
NVIDIA NIM llama-3.2-11b-vision Free credits Enterprise-grade inference
OpenAI gpt-4.1-mini / gpt-4.1 / gpt-4o Paid Most stable quality
Claude Haiku / Sonnet / Opus Paid Strong semantic understanding
Grok grok-2-vision-1212 / grok-4 Paid xAI flagship multimodal
๐Ÿฆ™ OLLAMA Any vision model Unlimited (local) Fully offline, no API key
๐Ÿ” OCR + Google EasyOCR + Google Translate Unlimited (free) Zero setup required

โš ๏ธ Free quota numbers are subject to change. Check each provider's official announcements for the latest limits.


๐Ÿ” Security & Transparency

LangForge is verified using Microsoft Process Monitor (Sysinternals).

The application makes only the API calls required for translation โ€” to the AI engine you have selected. No data is sent to any developer-controlled server.

  • โœ… API Keys stored locally in configs.json, encrypted with your machine ID
  • โœ… No upload of screenshots or personal data
  • โœ… No connection to developer servers
  • โœ… No remote license verification
  • โœ… SHA256 checksum published for every release
  • โœ… Full source code available for inspection

File Integrity Verification

Release File SHA256
V1.5.1 LangForge.exe EFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5 LangForge.exe AC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1 LangForge.exe 1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShell
Get-FileHash .\LangForge.exe -Algorithm SHA256

If the hash does not match, do not run the file. Re-download from the official page.


๐Ÿ› ๏ธ Requirements

Item Requirement
OS Windows 10 / 11 (64-bit recommended)
Network Required for cloud engines; OLLAMA and OCR modes work offline
API Key Required for cloud engines; not required for OLLAMA or OCR mode
Storage 1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA) NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMA Optional โ€” install from ollama.com for local engine
EasyOCR Optional โ€” pip install easyocr for local OCR mode

๐Ÿ“ Project Structure

LangForge/
โ”œโ”€โ”€ LangForge.py          # Main application
โ”œโ”€โ”€ platforms.json        # Game platform definitions
โ”œโ”€โ”€ emulators.json        # Emulator definitions
โ”œโ”€โ”€ requirements.txt      # Python dependencies
โ”œโ”€โ”€ configs.json          # User config (auto-generated, API keys encrypted)
โ”œโ”€โ”€ favicon.ico           # App icon
โ””โ”€โ”€ translation_logs/     # SQLite DB + screenshots (auto-generated)
    โ”œโ”€โ”€ langforge.db
    โ””โ”€โ”€ screenshots/

๐Ÿ—บ๏ธ Roadmap

  • Cloud engine support (Gemini, Groq, Mistral, OpenAI, Claude, Grok)
  • HuggingFace / Together AI / Cerebras / NVIDIA NIM engines
  • OLLAMA local engine
  • Local OCR + Google Translate mode (zero setup)
  • Simple Mode (Tab 7) โ€” streamlined local-engine interface
  • Session recording & playback with live delay mode
  • AI walkthrough analysis
  • Auto-capture with scene stability detection
  • Encrypted API key storage
  • Bilingual UI (็นไธญ / English)
  • Dark / Light theme toggle
  • Platform editor
  • One-click Advanced / Simple Mode switch
  • Multi-language UI (beyond zh/en)
  • macOS / Linux support (planned)

๐Ÿ’œ Support the Project

LangForge is built by a solo developer in spare time. If it's helped you enjoy a game you couldn't read before โ€” your support means a lot.

Platform Link Type
โ˜• Ko-fi ko-fi.com/toyakyo One-time or monthly
๐Ÿ’œ Patreon patreon.com/cw/LangForge $1โ€“3 / month
๐Ÿ’ฌ FB Community LangForge Official Community Free to join

๐Ÿ“ฌ Links

๐ŸŒ Official Docs https://goonsoft.tw2.nde.tw/tutorial/tutorial.php
๐Ÿ“ฅ Download https://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
๐Ÿ’ฌ FB Community https://www.facebook.com/groups/2150940378645437
โ˜• Ko-fi https://ko-fi.com/toyakyo
๐Ÿ’œ Patreon https://www.patreon.com/cw/LangForge

โš ๏ธ Disclaimer

LangForge is provided as-is during active development and may not be fully stable. Use at your own risk.
API usage costs (if any) are the responsibility of the user based on their chosen AI engine provider.
Translation results are AI-generated and may not always be accurate.


Copyright ยฉ 2026 GoOnSoft. All rights reserved.
Built with โค๏ธ by Toya Kyo โ€” Solo Developer from Taiwan ๐Ÿ‡น๐Ÿ‡ผ

Popular repositories Loading

  1. LangForge LangForge Public

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyo Public

    Config files for my GitHub profile.

    1