Skip to content

Fix bug, add local translator #288

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Casezy wants to merge 1 commit into from
Closed

Fix bug, add local translator #288

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
106 changes: 23 additions & 83 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,39 @@
<p align="center">
<img width="670" src="https://github.com/ramjke/Translumo/assets/29047281/8985049f-ea1c-428e-94be-042ece66cb54">
</p>
<h2 align="center" style="border: 0">Advanced Real-Time Screen Translator</h2>
<h2 align="center" style="border: 0">Advanced Real-Time Screen Translator (Agentic Custom Build)</h2>

<p align="center"><strong>English</strong> | <a href="docs/README-RU.md"><strong>Русский</strong></a></p>
<p align="center"><strong>English</strong> | <a href="docs/README-RU.md"><strong>Русский</strong></a> | <strong>Indonesian (Mod)</strong></p>

---

# 🚀 Agentic Mod - What's New & Fixed?

This version of **Translumo** has been heavily customized and fixed by an AI Agent (Antigravity). It includes exclusive features and major stability fixes that are not present in the original repository.

## ✨ New Features
1. **AI Translator Integration**: Added support for translating via Advanced AI Models (e.g., Gemini, ChatGPT/OpenAI compatible APIs) to achieve highly contextual and natural game translations.
2. **Local LibreTranslate Support**: Fully integrated a completely offline, local LibreTranslate server support. Translumo will automatically manage the server startup and shutdown without you needing to open the terminal.
3. **Clear Chat Hotkey (`ALT+C`)**: A newly implemented global hotkey that allows you to instantly clear the chat bubble/translation screen when it gets too cluttered.

## 🛠️ Major Bug Fixes & Stability Improvements
1. **Proxy Error Fixes**: Resolved persistent proxy errors that blocked connections to translators.
2. **LibreTranslate Lifecycle Manager**: Fixed a bug where simply opening or minimizing the Settings menu would aggressively kill the `port 5000` LibreTranslate server. The server is now safely managed by a background singleton manager and only shuts down when you completely exit Translumo from the tray.
3. **Restored Anti Double-Click**: Re-implemented the lock on the "Run LibreTranslate" button to prevent accidental spam-clicking that could cause duplicate server spawns.
4. **Dark Theme Removal**: Systematically removed the highly unstable, experimental Dark Theme feature that was causing Translumo to force-close and crash on startup.
5. **Setup Guide Improvements**: Added direct hyperlinks to the supported language codes inside the LibreTranslate guide within the app, making it extremely easy to copy-paste the exact `argospm` language model commands.

---

## Sibling Project
This project has a sibling called **[Lookupper](https://lookupper.com)** — an on-screen dictionary for language learning. It is similar to Translumo but built for a different purpose. Lookupper is built to help you *learn* a language, not just depend on a translator forever.

Lookupper is my commercial project with a free version. If you find it useful and decide to grab the Pro version, you'll also be supporting the development of both Lookupper and Translumo.


<a href="https://lookupper.com">
<img width="300" alt="Lookupper" src="https://github.com/user-attachments/assets/ef2f83b3-e15f-4bd3-826e-858266f36c93" />
</a>


## Download Translumo

**Direct download link to the latest version:**
Expand All @@ -44,7 +62,7 @@ Version 1.0.x includes many changes and improvements compared to versions 0.9.x.

- **Integrated modern OCR engines**: Windows OCR (recommended), Tesseract 5.2 (legacy), EasyOCR (legacy)

- **Available translators**: DeepL (recommended), Google Translate, Yandex Translate, Naver Papago.
- **Available translators**: DeepL (recommended), Google Translate, Yandex Translate, Naver Papago, AI Translator (Custom), LibreTranslate (Custom).

- **Supported recognition languages**: English, Russian, Japanese, Chinese (Simplified), Korean.

Expand All @@ -56,81 +74,3 @@ Version 1.0.x includes many changes and improvements compared to versions 0.9.x.
- Windows 10 version 2004 (build 19041) or later, or Windows 11
- DirectX 11 compatible GPU
- 2 GB RAM

### Minimal requirements to use EasyOCR
- NVIDIA GPU with CUDA SDK 11.8 support (GTX 750, 8xxM, 9xx series or newer)
- 8 GB RAM
- At least 5 GB of free storage space

## How to Use

![Preview](https://github.com/ramjke/Translumo/blob/7f4a73ffba0e5a0090ea0bfc3d72acb99832a0f4/docs/preview-EN.gif)

1. Open the Settings (**Alt+G**)
2. Select languages: source language for OCR and translation language
3. Select text recognition engines (see Usage Tips for recommended modes)
4. Define the capture area: press **Alt+Q** and select an area on the screen
5. Run translation (press **~**)

### Recommended OCR Engines

- It is recommended to use **WindowsOCR** only.

Tesseract is old, slow, and produces many errors.
EasyOCR is even slower, requires significant resources (including a specific GPU), and often leads to bugs.

It’s probably better to remove all other OCR engines and keep only WindowsOCR, but they are still included in Translumo for historical reasons.

### Select Minimum Capture Area
Reducing the capture area decreases the chance of picking up random letters from the background. Larger frames take longer to process.

### Use Proxy List to Avoid Blocking by Translation Services
Some translators may block clients sending many requests. Configure personal or shared IPv4 proxies (1-2 is usually enough) under **Languages → Proxy tab**. The app will alternate proxies to reduce requests from a single IP.

### Use Borderless or Windowed Modes in Games (Not Fullscreen)
These modes are required for correct translation overlay display. If your game does not support them, use tools like [Borderless Gaming](https://github.com/Codeusa/Borderless-Gaming).

## FAQ

**Q: I get "Failed to capture screen" or nothing happens after translation starts**
A: Ensure the target window is active. Restart Translumo or reopen the target window if needed.

**Q: Borderless/windowed mode is set, but the translation window is under the game**
A: With the game running and focused, press the hotkey (**Alt+T** by default) to hide and show the translation window.

**Q: EasyOCR package download failed**
A: Try reinstalling while connected to a VPN.

**Q: Hotkeys don't work**
A: Other applications may be intercepting hotkeys.

**Q: Text detection failed (TesseractOCREngine)**
A: Ensure the application path contains only Latin letters.

## Build

*Visual Studio 2022 and .NET 8 SDK are required.*

1. Clone the repository (the **master** branch always corresponds to the latest release):

```bash
git clone https://github.com/ramjke/Translumo.git
```

> Note: During the build, **binaries_extract.bat** will automatically download and extract models and Python binaries (~400 MB) to the target output directory.

## Credits

- [Material Design In XAML Toolkit](https://github.com/MaterialDesignInXAML/MaterialDesignInXamlToolkit)
- [Tesseract .NET wrapper](https://github.com/charlesw/tesseract)
- [OpenCvSharp](https://github.com/shimat/opencvsharp)
- [Python.NET](https://github.com/pythonnet/pythonnet)
- [EasyOCR](https://github.com/JaidedAI/EasyOCR)
- [Silero TTS](https://github.com/snakers4/silero-models)

## Alternative Solutions

- [Lookupper](https://lookupper.com) — on-screen dictionary and translator for language learning.
- [ScreTran](https://github.com/PavlikBender/ScreTran) — simple screen translator.
- [ScreenTranslator](https://github.com/OneMoreGres/ScreenTranslator) - screen capture, OCR and translation tool.

Loading