ocrhelper 1.2.1

Tool for translating text from the screen and some more

EN | RU

Advanced Screen Assistant. OCRHelper is able to translate text from the selected area. It is also possible to search for the meaning of a word using ChatGPT, as well as simply copy it to the clipboard.

Main features

• High text recognition precision
OCR Helper for text recognition uses EasyOCR, which handles most of the daily text reading requirements.
• Simple interface
The main idea was to make tool, that does not require manual adjustments for each case and convenient for everyday use.
• Available translators: Google Translate, ChatGPT, ChatGPT with streaming display
• Available recognition and translation languages: English, Russian, Japanese
• Dictionary: mode for finding the meaning of a word using ChatGPT
• Recognition: mode for only text recognition, can be used with the option to copy text to the clipboard

System requirements

• Windows 10 build 19041 (20H1) / Windows 11
• DirectX11
• 1 GB free RAM
• 5 GB free storage space/ 1 GB for without_cuda version
• Nvidia GPU with CUDA SDK 11.8 support (GTX 750, 8xxM, 9xx series or later) (for mode using CUDA)

How to use

1. Choose the version that suits you: the regular version weighs more and takes more time to start, but reads text faster, the without_cuda version is the opposite (you can download any of them here)
2. Launch the application (The first launch will take much longer than the subsequent ones)
3. Open the menu using CTRL + ALT + X or via the tray
4. Open the settings
5. Select the necessary languages for recognition (the fewer selected, the more accurate the recognition)
6. Select a translator (you will need to enter an API-key to use GPT)
7. (Optional) Change the color of the area selection in the palette
8. Press CTRL + SHIFT + X to select an area and then translate
9. Wait for the translation result

Usage Tips

Should install a non-standard font

This should be done to better display the application window

To do this, go to "ocrhelper/additional files", run "Rubik.ttf", click "install"

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).

Error

If an error occurs while running the application, please create a new issue in the Issues tab. I will try to respond to the problem as soon as I see it.

TODO

• Move app on PyQT
• Add gamepad support for selecting area

For dev

• Clone repository

git clone https://github.com/ReYaNOW/OCRHelper.git

• Install dependencies

make install

or

make install_without_cuda

Dependencies

• Python 3.11+
• Poetry
• Python libraries
• CustomTkinter
• Deep-translator
• Pystray
• Keyboard
• Pillow
• Numpy
• Keyring
• CTkMessagebox