> For the complete documentation index, see [llms.txt](https://docs.vntranslator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vntranslator.com/help/troubleshooting/textractorcli.md).

# TextractorCLI

TextractorCLI is a third-party integration. VNTranslator does not provide support for game-specific hooking issues. For problems related to text extraction from specific games, please refer to the [Textractor GitHub Issues page](https://github.com/Artikash/Textractor/issues).

## Error Dialog: "Textractor ERROR"

<div align="left"><figure><img src="/files/HElWtiqGxuUOfj029P42" alt=""><figcaption><p>Textractor ERROR</p></figcaption></figure></div>

* Check the [Textractor GitHub Issues page](https://github.com/Artikash/Textractor/issues) for known problems with your specific game
* Search for your game title or error message to find solutions from the community
* Make sure you're using the correct architecture (x86 vs x64) for your game

***

## Smart Filtering Window is Blank / No Text Appears

#### 1. Do not run Textractor.exe while using TextractorCLI

VNTranslator automatically launches `TextractorCLI.exe` to hook game text. If you manually run `Textractor.exe` at the same time, it will cause a conflict because both programs try to use the same text extraction pipeline. This prevents the text from being sent to VNTranslator.

#### 2. Run VNTranslator as Administrator

Text hooking requires elevated permissions to inject into game processes.

#### 3. Add TextractorCLI.exe to antivirus exceptions

Antivirus software often blocks text hooking programs because they inject code into running processes.

#### 4. Verify the TextractorCLI path is correct

Make sure the path in VNTranslator settings points to the correct TextractorCLI.exe file.

**Example paths:**

* `C:\Textractor\x86\TextractorCLI.exe` (for 32-bit)
* `C:\Textractor\x64\TextractorCLI.exe` (for 64-bit)

#### 5. Ensure your game engine is supported

Not all game engines are compatible with Textractor. Check the [Textractor GitHub Issues page](https://github.com/Artikash/Textractor/issues) to see if your specific game or engine is supported.

***

## **Newer Visual Novel Games Not Working**

Textractor is no longer actively developed, so some newer visual novel games may not work with the current version.

**Solution:** Update the `texthook.dll` file in your Textractor installation folder with a newer community-maintained version.

***

## Testing TextractorCLI

<figure><img src="/files/M1T5ba7f6PCm4huektHz" alt=""><figcaption><p>Console</p></figcaption></figure>

You can verify if TextractorCLI is working correctly by running it manually:

* Open the Run Command (Windows key + R)
* Type the path to TextractorCLI.exe:&#x20;
  * `C:\Textractor\x86\TextractorCLI.exe` (for 32-bit)
  * `C:\Textractor\x64\TextractorCLI.exe` (for 64-bit )
* Click **OK** to confirm
* Check the output\
  If TextractorCLI is working correctly, you should see output like this in the console window:`[1:0:0:FFFFFFFFFFFFFFFF:FFFFFFFFFFFFFFFF:Clipboard:HB0@0]`\
  If the clipboard address appears in the console, TextractorCLI is functioning properly.

***

## **Additional Troubleshooting Tips**

* **Game crashes when hooking:** Try using a different architecture (x86 vs x64) or check if the game has anti-cheat protection
* **Garbled or duplicate text:** Use the Smart Filtering feature in VNTranslator to filter out unwanted text threads
* **No hooks detected:** Some games require custom H-codes. Search for your game on the Textractor GitHub Issues page or VNDB to find working H-codes
* **Still having issues?** Consider using the Clipboard Integration method as an alternative, which is often more stable