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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
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.

Content in all repositories owned by your account will be closed.
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.

VersionPlatformOpen SourceKo-fiPatreon

📥 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

FeatureDescription
🖼️ Overlay TranslationTranslated text positioned directly on the game screenshot
🌐 Multi-Language OutputJapanese, English, Korean, French, German, Spanish, Italian, Portuguese, Russian, and more
📐 Horizontal / Vertical LayoutSupports both Western (L→R) and Japanese-style (top→bottom, R→L) text direction
🔤 Auto Font MatchingOverlay font auto-selected based on target language (JP, KR, RU, etc.)
📋 AI Walkthrough Analysis3–5 actionable hints based on the current game screen
Auto-CaptureDetects scene stability and triggers translation automatically
⌨️ Global HotkeysTrigger translation or walkthrough without leaving your game
🎬 Session RecordingRecords your play session with playback and live delay mode
🗂️ Translation HistorySQLite-backed records with screenshot, organized by game and platform
🔐 Encrypted API KeysKeys encrypted with your machine ID (XOR + base64) before saving locally
🖱️ Click-to-Select WindowClick 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 ThemeToggle UI theme from the View menu
🌍 Bilingual UISupports 繁體中文 and English, toggle anytime from the menu
🔄 Auto Engine RotationAutomatically switches to the next available engine when free quota runs out
📊 Quota DashboardReal-time view of today's usage per model, with RPM and RPD tracking
🛠️ Platform EditorAdd, rename, or remove game platforms and emulators directly in the UI
🔀 One-Click Mode SwitchToggle 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

EngineRecommended ModelFree Daily QuotaNotes
Geminigemini-3-flash500 RPDNew-gen Flash, recommended
Geminigemini-2.5-flash20 RPDStable, strong vision
Groqqwen/qwen3.6-27b1,000 RPDMultimodal, fast
Mistralmistral-small-latest500 RPDVision support
HuggingFaceLlama-3.2-11B-VisionFree tierOpen-source vision models
Together AILlama-Vision-FreeUnlimited (free)Permanently free vision model
Cerebrasgemma-4-31b~2,100 RPD1,800+ tok/s, ultra fast
NVIDIA NIMllama-3.2-11b-visionFree creditsEnterprise-grade inference
OpenAIgpt-4.1-mini / gpt-4.1 / gpt-4oPaidMost stable quality
ClaudeHaiku / Sonnet / OpusPaidStrong semantic understanding
Grokgrok-2-vision-1212 / grok-4PaidxAI flagship multimodal
🦙 OLLAMAAny vision modelUnlimited (local)Fully offline, no API key
🔍 OCR + GoogleEasyOCR + Google TranslateUnlimited (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

ReleaseFileSHA256
V1.5.1LangForge.exeEFE1E645BF88CB359B0D48BD4E29DDDABF157FABCC433D3AF5C359B123B6B793
V1.5LangForge.exeAC62B71FADE75FD6E06DFA228E9E2E1759ACD65252E14A9A80BD52BB96FEA083
V1.1.1LangForge.exe1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
# Verify in PowerShellGet-FileHash .\LangForge.exe-Algorithm SHA256

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


🛠️ Requirements

ItemRequirement
OSWindows 10 / 11 (64-bit recommended)
NetworkRequired for cloud engines; OLLAMA and OCR modes work offline
API KeyRequired for cloud engines; not required for OLLAMA or OCR mode
Storage1GB+ recommended (translation history and session recordings accumulate locally)
GPU (OLLAMA)NVIDIA GPU with 4GB+ VRAM recommended for local inference
OLLAMAOptional — install from ollama.com for local engine
EasyOCROptional — 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.

PlatformLinkType
☕ Ko-fiko-fi.com/toyakyoOne-time or monthly
💜 Patreonpatreon.com/cw/LangForge$1–3 / month
💬 FB CommunityLangForge Official CommunityFree to join

📬 Links

🌐 Official Docshttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php
📥 Downloadhttps://goonsoft.tw2.nde.tw/tutorial/tutorial.php#download
💬 FB Communityhttps://www.facebook.com/groups/2150940378645437
☕ Ko-fihttps://ko-fi.com/toyakyo
💜 Patreonhttps://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 LangForgePublic

    AI-powered game screenshot translator

    Python 3

  2. toyakyo toyakyoPublic

    Config files for my GitHub profile.

    1