Danily07 / Translumo

Advanced real-time screen translator for games, hardcoded subtitles in videos, static text and etc.
Apache License 2.0
3.32k stars 165 forks source link
autotranslate easyocr game-translation mlnet ocr translation

License [Github All Releases]()

EN | RU

Advanced screen translator. Translumo is able to detect and translate appearing in the selected area text in real-time (e.g. subtitles).

Main features

System requirements

How to use

  1. Open the Settings
  2. Select Languages->Source language and Languages->Translation language
  3. Select Text recognition->Engines (please check Usage tips for recommendation modes)
  4. Select capture area
  5. Run translation

Usage tips

Generally, I recommend always keep Windows OCR turned on. This is the most effective OCR for the primary text detection with less impact on performance.

Recommended combinations of OCR engines

Select minimum capture area

It reduces chances of getting into the area random letters from background. Also the larger frame will take longer to process.

Use proxy list to avoid blocking by translation services

Some translators sometimes block client for a large number of requests. You can configure personal/shared IPv4 proxies (1-2 should be enough) on Languages->Proxy tab. The application will alternately use proxies for requests to reduce number from one IP address.

Use Borderless/Windowed modes in games (not Fullscreen)

It is necessary to display the translation window overlay correctly.

If the game doesn't have such mode, you can use external tools to make it borderless (e.g. Borderless Gaming)

Install the application on SSD

To reduce cold launch time with enabled EasyOCR engine (loading large EasyOCR model into RAM).

FAQ

I got error "Failed to capture screen" or nothing happens after translation starts

Make sure that target window with text is active. Also try to restart Translumo or reopen target window.

I got error "Text translation is failed" after successful using the translation

There is a high probability that translation service temporarily blocked requests from your IP. You can change translator or configure proxy list.

Can't enable Windows OCR

Make sure that the application is runned as an Administrator. Translumo each time tries check installed Windows language pack via PowerShell.

I set borderless/windowed mode, but a translation window is still displayed under a game

When game is running and focused use the hotkey (ALT+T by default) to hide and then show again translation window

Package downloading for EasyOCR failed

Try to re-install it under VPN

Hotkeys don't work

Other applications may intercept specific hotkeys handling

I got error "Text detection is failed (TesseractOCREngine)"

Make sure that the application path contains only latin letters.

Build

Visual Studio 2022 and .NET 7 SDK are required

Credits