Become a PatronJoin Our Discord

OCR

This guide helps you resolve common issues when using OCR (Optical Character Recognition) in VNTranslator.

Display and Monitor Issues

Supported Monitor Configurations

VNTranslator OCR supports various monitor setups:

  • OCR version 1.x: Single monitor only

  • OCR version 2.x: Multi-monitor support (horizontal arrangement / X-axis)

  • OCR version 3.x: Multi-monitor support (horizontal and vertical arrangement / X & Y-axis)

Display Scaling Issue

Problem: The OCR Capture Area doesn't align with the actual text position on screen, or captured images appear cropped or misaligned.

Cause: Windows display scaling affects what you see on screen, but OCR captures the actual pixel coordinates without scaling.

Solution:

VNTranslator Pro supports display scaling. Configure it in the app settings:

  • Open VNTranslator Settings.

  • Go to App Settings -> Display -> Scale.

  • Select the appropriate scale setting that matches your Windows display scaling.

  • Relaunch VNTranslator.

Alternative solution:

If issues persist, you can change Windows display scaling to 100%:

  • Open Windows Settings

  • Go to System -> Display

  • Set Scale to 100% for the monitor where you're running your game

  • Relaunch VNTranslator

Note: VNTranslator Pro now supports display scaling through app settings, but using 100% Windows scaling can still provide the most consistent results.

Graphics Card Issue

List of Error Messages:

  • Error Code 11x

  • Screen capture failed

  • Display source not detected!

1. Update Graphics Drivers

Windows Update doesn't always provide the latest drivers. Download directly from your graphics card manufacturer:

  • NVIDIA drivers: http://www.nvidia.com/content/drivers/

  • AMD drivers: http://support.amd.com/en-us/download

  • Intel drivers: https://downloadcenter.intel.com/

2. Switch Between GPUs (Multi-GPU Systems)

If your computer has more than one graphics card, then Try to switch between Dedicated GPU & Integrated GPU.

  • NVIDIA Optimus: Go to NVIDIA Control Panel -> Manage 3D settings -> Program Settings

  • AMD Switchable: Go to AMD Radeon Settings -> Switchable Graphics

3. Disable capture/recording in GeForce Experience / AMD Radeon

Graphics card recording features can interfere with OCR screen capture.

  • GeForce Experience: Disable In-Game Overlay, Disable Dekstop Capture (Privacy control), Disable Instant Replay

  • AMD Radeon: Disable In-Game Overlay, Disable Record Dekstop, Disable Instant Replay, Disable In-Game Replay

4. Disable hardware acceleration

If other solutions don't work, try disabling hardware acceleration in VNTranslator.

  • Method 1: Via VNTranslator Settings: Go to Settings -> App Settings -> Advanced -> Hardware acceleration

  • Method 1: Via Command Line C:\Program Files\VNTranslator\VNTranslator.exe --disable-gpu C:\Program Files\VNTranslator\VNTranslator.exe --disable-gpu --force-cpu-draw

Screen Capture Error Occurs

List of Error Messages:

  • Error Code 10x

  • Main function error

  • Image processing error

  • Undefined image

  • Screen capture failed

  • INVALID_ARGUMENT - Request must specify image and features

Solution 1: Run as Administrator

  • Right-click VNTranslator.exe

  • Select Run as administrator

Solution 2: Reinstall for All Users

  • Uninstall VNTranslator

  • Reinstall and choose Install for all users

  • Install to: C:\Program Files\VNTranslator

Solution 3: Install/Update Visual C++ Redistributable

Solution 4: Change Display Source

  • Open VNTranslator Settings

  • Go to App Settings -> Display

  • Change Display Source to either Native or Windows

  • Relaunch VNTranslator

OCR Server Connection Issues

Problem: "Unable to connect to OCR Server" or the OCR process hangs for 15-60 seconds without responding.

Possible causes:

  • Insufficient RAM

  • Firewall blocking the connection

  • Tesseract OCR or Window OCR Server not responding

Solution 1: Run as Administrator

  • Right-click VNTranslator.exe and select Run as administrator

Solution 2: Configure Windows Firewall

  • Open Windows Security -> Firewall & network protection

  • Click Allow an app through firewall

  • Click Change settings -> Allow another app

  • Browse to C:\Program Files\VNTranslator\VNTranslator.exe

  • Add VNTranslator and allow it on both Private and Public networks

Note: If you're using third-party firewall software (BitDefender, Norton, McAfee), add VNTranslator as an exception in that software.

Solution 3: Disable Tesseract Server

  • Open VNTranslator Settings

  • Go to OCR Settings

  • Disable Tesseract Server (this will use Tesseract Wrapper instead)

Tesseract is not installed

Solution:

  • Download Tesseract OCR from the official source

  • Install to: C:\Program Files\Tesseract-OCR

  • Make sure the installation path is exactly as shown above

  • Relaunch VNTranslator

Tesseract process exited with code 1 - Command failed: ???

Solutions 1: Reinstall Tesseract:

  • Uninstall Tesseract completely

  • Restart your computer

  • Download and reinstall Tesseract

  • Install to: C:\Program Files\Tesseract-OCR

Solution 2: Try a different Tesseract version

  • Download alternative versions from the Tesseract releases

Search for specific error

  • Search on Google or Stack Overflow for solutions specific to that error 🙃

TESSDATA_PREFIX is not set to your tessdata directory

Solution:

  • Open Command Prompt as administrator

  • type setx TESSDATA_PREFIX "C:\Program Files\Tesseract-OCR\tessdata", and then press Enter

  • Restart your computer

Err: Failed to init API, possibly an invalid tessdata path: ./

Solution:

  • Open Command Prompt as administrator

  • type setx TESSDATA_PREFIX "C:\Program Files\Tesseract-OCR\tessdata", and then press Enter

  • Restart your computer

Google Lens - Request failed with status code 303

Solution:

  • Restart your modem/router

  • Use a VPN

  • Or use a more stable offline OCR engine such as Fast OCR and Tesseract 😄

PreviousDeepSeek API Error CodesNextAutoTrans