Understanding Overlay Translator: Real-Time On-Screen Translation Framework
Visual language barriers pose a persistent challenge across modern digital desktop environments. Software applications, digital video games, technical schematics, scanned PDF files, and live streaming video content frequently display non-selectable text embedded directly into visual frames. Because these pixels are rendered on screen without accessible text strings in the system clipboard or document object model, standard text-copy workflows and browser extensions fail. The open-source desktop software application known as Overlay Translator (hosted in the public GitHub repository ciddwd/overlay-translator) addresses this challenge directly on Microsoft Windows operating systems. By capturing designated desktop regions, processing visual content through optical character recognition (OCR), translating text via cloud services or local neural networks, and rendering the translated output on a transparent overlay, the application turns static desktop pixels into readable multi-language text in real time.
Traditional translation applications rely on application-level process hooks, executable memory reading, or manually copied clipboard buffers. Memory injection and process hooking introduce significant security risks, application instability, and anti-cheat false positives in interactive media. Overlay Translator completely avoids modifying target binaries or hooking into process memory spaces. Instead, it operates strictly at the desktop display layer, ingesting composited pixels via native graphics APIs and overlaying target language text directly over the original visual source.
The framework is built around a modular architecture that decouples image capture, text recognition, translation processing, and target overlay rendering. This modularity allows users to freely mix and match local offline components with cloud APIs. Users can choose between minimal resource usage for basic desktop software, maximum linguistic precision for complex literature, or complete air-gapped isolation for privacy-sensitive enterprise environments.
Architecture and System Processing Pipeline
The operational workflow of Overlay Translator relies on a multi-stage sequential execution pipeline. This pipeline guarantees deterministic data processing with minimal frame latency from initial display pixel extraction to target language text composition on screen.
1. Region Capture and Display Frame Ingestion
The translation lifecycle initiates when a user presses a designated global hotkey or when an automated capture loop polls specified desktop coordinates. The application acquires screen pixels using low-overhead display pipelines, such as the Windows Graphics Capture API or the Desktop Duplication API (DXGI). The capture engine isolates a precise bounding box defined by explicit display parameters (X position, Y position, width, height). Operating purely on display frame buffers guarantees universal compatibility across software applications regardless of underlying graphics engines or application architecture.
2. Optical Character Recognition (OCR) Engine Routing
Once a screen capture frame is isolated, it is dispatched to the configured OCR execution engine. The framework supports multiple OCR backends to balance accuracy, execution speed, and language capabilities:
- Windows Media OCR: Leverages native optical character recognition APIs built into modern Windows operating systems. It provides fast runtime execution, low hardware consumption, and zero external dependency downloads.
- PaddleOCR: Integrates deep-learning recognition models optimized for multi-oriented text, dense character arrangements, vertical text orientation, and East Asian language scripts (including Japanese, Simplified Chinese, Traditional Chinese, and Korean).
- Tesseract OCR: Employs an open-source neural network OCR engine that provides flexible multi-language recognition across a wide variety of global scripts and uncommon character sets.
The OCR stage outputs structured character metadata containing recognized text strings, confidence scores, and relative spatial coordinate bounding boxes for every detected line or text segment.
3. Text Normalization, Reconstruction, and Line Aggregation
Raw OCR outputs often fragment contiguous sentences into disconnected lines, misinterpret line breaks, or add unwanted spacing artifacts caused by visual font kerning. The internal text processing engine normalizes extracted characters, strips redundant line wraps, merges split sentence structures, and enforces language-specific typographical rules. For example, the engine automatically removes spaces between adjacent CJK (Chinese, Japanese, Korean) characters while retaining spaces between Latin script words.
4. Translation Backend and LLM Prompt Routing
The normalized text string is forwarded to the designated machine translation service layer. Overlay Translator abstracts provider interactions through a modular backend system:
- Cloud Neural Translation APIs: Directs text to cloud translation APIs such as DeepL API, Google Translate, Baidu Translate, or Caiyun API via RESTful JSON interfaces.
- Large Language Model (LLM) Endpoints: Interfaces with OpenAI ChatCompletions APIs (including GPT-4o and GPT-3.5-Turbo), Anthropic Claude APIs, or local OpenAI-compatible inference servers (such as Ollama, LM Studio, or vLLM). This path enables context-aware translation, term glossaries, and custom prompt formatting.
- Offline Neural Machine Translation Engines: Directs translation requests to local offline translation models, allowing completely disconnected operation without sending sensitive text to cloud servers.
5. Transparent Desktop Rendering and Spatial Overlay
Upon receiving the target language translation, the user interface layer constructs a top-most, transparent WPF (Windows Presentation Foundation) overlay window. The renderer fits the translated text precisely within the visual bounding coordinates of the original source text. It applies configurable background opacity, custom typography styling, high-contrast outline strokes, and click-through window attributes to maintain seamless desktop interaction.
Core Capabilities and Technical Features
Overlay Translator offers a versatile feature set designed to deliver reliable translation accuracy, clean visual readability, and fluid performance during continuous operation.
Modular Engine Swapping
Users are not locked into a single fixed vendor pipeline. The application allows independent configuration of both the OCR recognition engine and the translation provider. A user can run native Windows Media OCR locally for low CPU usage while routing translated text through an OpenAI API model using custom prompt guidelines. Alternatively, a user can pair local PaddleOCR processing with DeepL API to achieve optimal translation quality for complex Japanese visual novels or manga dialogue.
Dynamic Bounding Box Selection and Multi-Region Monitoring
The interactive bounding box tool lets users define temporary or persistent capture regions over specific game windows, media players, or document viewers. Multi-region monitoring allows distinct screen elements—such as subtitle banners, dialogue boxes, status menus, or combat logs—to be tracked and translated independently across the desktop view.
Input Passthrough and Click-Through Window Transparency
To prevent active text overlays from blocking desktop interaction, the visual layer supports input passthrough using native Windows Extended Window Styles (WS_EX_TRANSPARENT and WS_EX_LAYERED). When click-through mode is active, mouse clicks, drags, scroll events, and keyboard input pass directly to the underlying application or game without triggering focus loss or input interruption.
Customizable Typography and Contrast Styling
Visual readability varies depending on background colors, video frames, and dynamic game environments. The text overlay engine provides extensive visual customization tools:
- Font Selection and Scaling: Choose custom system fonts, adjust font size scaling, and fine-tune spatial padding.
- Color and Transparency Controls: Adjust foreground text colors, solid or semi-transparent background fill colors, and alpha opacity levels.
- Stroke Outlining: Apply customizable text outline stroke weights and stroke colors to ensure legibility against light, dark, or busy background graphics.
- Alignment and Wrapping: Support for left, center, right, and justified alignment, paired with automatic multi-line word wrapping inside boundary boxes.
Prompt Engineering and Terminology Glossaries
When using Large Language Model (LLM) backends, users can define custom system prompts and domain glossaries. This capability allows the system to consistently translate character names, technical jargon, fantasy terms, and specialized domain vocabulary according to user-defined rules.
Comparison with Alternative Translation Solutions
Understanding how Overlay Translator compares to alternative translation tools highlights its advantages across system intrusiveness, target application compatibility, anti-cheat safety, and UI flexibility:
| Feature / Metric | Overlay Translator | Standard Web Translators | Process Hooking Tools | Mobile Camera OCR Apps |
|---|---|---|---|---|
| Capture Source | Desktop Display Pixels (OCR) | Manual Clipboard Copy | Process Memory Text Hooks | Physical Camera Feed |
| Target Compatibility | Universal (Any visible screen content) | Selectable Text Only | Compatible Win32/x64 Binaries | Physical Displays / Printed Paper |
| System Intrusiveness | Non-intrusive (Pixel Reading) | None | High (Hooks Memory / DLL Injection) | None |
| Anti-Cheat Safety | Safe (Zero Process Injection) | Safe | High Risk (Triggers Security Flags) | Safe |
| LLM & API Flexibility | High (Custom APIs & System Prompts) | None (Fixed Web Engine) | Variable (Extension Dependent) | None (Fixed Mobile Engine) |
| UI Integration | Direct In-Place Transparent Overlay | Separate Browser / Window | Detached Floating Text Box | Mobile Phone Screen Overlay |
Detailed Breakdown of Alternatives
Standard Web Translators: Tools like Google Translate or DeepL web interfaces require users to manually select and copy text into a web browser. They cannot read rendered graphics, embedded PDF text, stream video banners, or digital game dialogues.
Process Hooking Tools: Applications like Textractor hook into target process memory space to extract internal text strings from running game code. While effective for compatible software, process hookers break on non-standard engines, cannot read pre-rendered text graphics, and carry a high risk of triggering anti-cheat bans in online titles. Overlay Translator avoids these risks entirely by operating externally on composited display pixels.
Mobile Camera OCR Applications: Mobile translation apps require pointing a smartphone camera at a desktop display screen. This approach creates physical alignment friction, sub-optimal refresh latency, moiré patterns, variable lighting glare, and physical arm fatigue during extended sessions.
Installation and Prerequisites Guide
System Requirements
- Operating System: Microsoft Windows 10 (Version 1809 or higher) or Microsoft Windows 11 (64-bit editions).
- Runtime Framework: .NET Desktop Runtime (v6.0, v7.0, or v8.0 depending on the target release build).
- Hardware Requirements: Standard x86_64 dual-core processor or better. A dedicated GPU is recommended when running local PaddleOCR deep learning models or local LLM inference engines.
- System Dependencies: Visual C++ Redistributable runtime libraries (x64) for native C++ dynamic link libraries used by PaddleOCR.
Standard Binary Installation Workflow
- Navigate to the releases page of the official
ciddwd/overlay-translatorGitHub repository. - Download the latest pre-compiled release archive (for example,
OverlayTranslator-vX.Y.Z.zip). - Extract the ZIP archive contents to a accessible local directory, such as
C:ToolsOverlayTranslator. - Launch
OverlayTranslator.exeto open the main user interface.
Building from Source Code (.NET CLI)
Developers who prefer compiling the latest source code directly using the .NET Command Line Interface (CLI) or Visual Studio can use the following steps:
- Clone the Git repository to your local computer:
git clone https://github.com/ciddwd/overlay-translator.git cd overlay-translator - Restore required NuGet package dependencies:
dotnet restore - Compile the application binary in Release configuration:
dotnet build --configuration Release - Publish the deployment package:
dotnet publish -c Release -r win-x64 --self-contained false
Operational Workflows and Configuration Manual
Initial Application Configuration
- Launch
OverlayTranslator.exe. - Open the Settings panel using the application window or system tray icon.
- Select your preferred OCR Engine. Choose
WindowsMediaOCRfor low resource usage orPaddleOCRfor foreign script accuracy. - Select your primary Translation Service Provider.
- Enter required service credentials, API authentication keys, or local network endpoints:
- DeepL API: Provide your API authentication key.
- OpenAI API: Enter your API Key, specify the target model (e.g.,
gpt-4o), and set a custom endpoint URL if connecting to local LLM proxies. - Baidu / Google / Caiyun: Supply valid API App IDs, Secret Keys, or token strings.
- Define the primary Source Language (or choose Auto-Detect) and your target Destination Language.
- Assign regional capture shortkeys under the Hotkeys tab, setting combinations like
Ctrl + Alt + Tto trigger region selection.
Executing Real-Time Translation Sessions
- Open the target video game, non-searchable document, or media stream on your primary monitor.
- Press your configured Selection Hotkey.
- Click and drag the mouse cursor over the on-screen region containing foreign text.
- Release the mouse button. The system captures screen coordinates, recognizes text via the selected OCR engine, translates the content, and renders the result directly over the target area.
- Use the clear hotkey or UI toggle to dismiss the active overlay when finished.
Configuration JSON Reference Schema
Overlay Translator stores configuration settings within localized JSON configuration files (typically config.json). The JSON schema snippet below shows how operational properties are defined for OCR parameters, OpenAI endpoints, DeepL configurations, and visual overlay formatting:
{
"General": {
"SourceLanguage": "ja",
"TargetLanguage": "en",
"AutoCopyResult": false,
"TopMostOverlay": true,
"ClickThrough": true
},
"OcrConfig": {
"Engine": "WindowsMediaOcr",
"Padding": 5,
"BinarizationThreshold": 128
},
"TranslationConfig": {
"Engine": "OpenAI",
"OpenAI": {
"ApiKey": "sk-proj-your-api-key-here",
"Endpoint": "https://api.openai.com/v1/chat/completions",
"Model": "gpt-4o",
"Temperature": 0.3,
"SystemPrompt": "You are a professional translator specializing in visual novels and video games. Translate Japanese text accurately into natural English while maintaining context and tone."
},
"DeepL": {
"ApiKey": "",
"IsPro": false
}
},
"RenderStyle": {
"FontFamily": "Segoe UI",
"FontSize": 16.0,
"TextColor": "#FFFFFFFF",
"BackgroundColor": "#80000000",
"StrokeColor": "#FF000000",
"StrokeThickness": 1.5
}
}
Application integrations occur at the host application level via setting files, graphical user controls, and global hotkey bindings. The system operates as a desktop client and does not publish an external software development kit (SDK).
Primary Use Cases and Application Scenarios
1. Interactive Video Games, JRPGs, and Visual Novels
Overlay Translator is widely used for playing untranslated foreign video games, JRPGs, and visual novels. Gamers can place capture bounding boxes directly over dialogue UI windows. Because the software reads pixels externally without modifying game binaries or injecting DLLs, it functions safely alongside anti-cheat technologies.
2. Technical Documentation, CAD Schematics, and Scanned PDFs
Engineers, researchers, and students working with non-searchable scanned PDFs, circuit schematics, or embedded UI strings can translate on-screen content in place without manual typing or camera scanning.
3. Livestreams, Video Feeds, and Digital Media
Users watching foreign livestreams, webinars, or graphical web comics can capture specific screen regions to translate static banners, dynamic subtitles, and graphical annotations on demand without interrupting video playback.
4. Air-Gapped and Privacy-Sensitive Workspaces
In secure enterprise environments, sending screen text to public cloud APIs may violate data privacy policies. By pairing offline OCR engines (like Windows Media OCR or local PaddleOCR) with local OpenAI-compatible inference servers (such as Ollama or LM Studio), organizations can process confidential screen content entirely within an air-gapped local network.
Community Support and Contributions
The ciddwd/overlay-translator project accepts open-source contributions from developers, localization specialists, and UI engineers. Key community participation areas include:
- Pull Requests: Code contributions for bug fixes, new OCR engine support, UI localization, or new translation API connectors should follow standard C# and .NET coding guidelines.
- Issue Tracking: Bug reports, character recognition edge cases, or feature requests can be submitted via the GitHub Issues page, complete with OS build version details, hardware specifications, application logs, and target screen screenshots.
Project Summary and Reference Links
Overlay Translator connects raw desktop graphics with modern machine translation engines. By offering a modular design, customizable OCR engines, LLM integration, and a transparent overlay renderer, it turns static screen graphics into accessible target-language text.
- Source Code Repository: GitHub – ciddwd/overlay-translator
- Issue Tracker: GitHub Issues
What is Overlay Translator and how does it function?
Overlay Translator is an open-source Windows desktop application designed to translate on-screen visual text in real time. It captures user-selected screen regions, extracts text using optical character recognition (OCR) engines, processes strings through cloud translation APIs or local Large Language Models (LLMs), and renders translated text directly over the original content on a transparent visual overlay.
Which operating systems and runtime environments are required to run Overlay Translator?
The application targets Microsoft Windows 10 (Version 1809 or higher recommended) and Windows 11 (64-bit). It requires the .NET Desktop Runtime (v6.0, v7.0, or v8.0 depending on the specific release build) and Visual C++ Redistributable packages (x64) for native OCR libraries such as PaddleOCR.
Can Overlay Translator operate completely offline without an internet connection?
Yes, Overlay Translator supports air-gapped offline operation when configured with offline OCR engines (such as Windows Media OCR or local PaddleOCR) alongside local translation models or local OpenAI-compatible LLM servers (such as Ollama or LM Studio).
How does Overlay Translator integrate with OpenAI models and local LLM endpoints?
Overlay Translator includes a modular routing layer compatible with OpenAI ChatCompletions APIs. Users can enter API keys, specify base endpoint URLs for local LLM servers, set model temperature settings, and supply custom system prompts for domain-specific context retention.
Is using Overlay Translator safe when running games protected by anti-cheat software?
Yes, Overlay Translator operates as a non-intrusive desktop composition overlay that captures screen display pixels using standard Windows Graphics APIs. Because it does not hook into target game executables, read process memory, or inject DLLs, it avoids triggering anti-cheat mechanisms.
Which translation providers and APIs are supported by the framework?
The system supports a broad selection of translation services, including DeepL API, Google Translate, Baidu Translate, Caiyun API, OpenAI ChatCompletions (such as GPT-4o and GPT-3.5-Turbo), Anthropic Claude API, local OpenAI-compatible proxies, and offline translation engines.
How can users customize font styling and transparent overlay aesthetics?
Users can customize font families, font sizes, text foreground colors, background fill opacity, stroke outline weights, and stroke colors via the GUI or config.json file. The renderer also supports left, center, right, and justified alignments along with automatic multi-line word wrapping.
What is the procedure for building Overlay Translator from source code?
Building from source requires cloning the ciddwd/overlay-translator GitHub repository and using the .NET SDK command line interface. Developers execute dotnet restore to fetch NuGet package dependencies, followed by dotnet build –configuration Release or dotnet publish to output executable binaries.
How does Overlay Translator handle character recognition and line breaks for East Asian scripts?
The internal text normalization engine cleans up OCR line fragmentation by joining split sentence boundaries and stripping unwanted whitespace. It automatically applies language-specific rules, such as removing spaces between CJK characters while maintaining proper spacing for Latin script words.
