Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/artikash/textractor

Extracts text from video games and visual novels. Highly extensible.
https://github.com/artikash/textractor

cpp games hacking reverse-engineering

Last synced: 2 days ago
JSON representation

Extracts text from video games and visual novels. Highly extensible.

Awesome Lists containing this project

README 

        
# Textractor



![How it looks](screenshot.png)



[English](README.md) ● [Español](README_ES.md) ● [简体中文](README_SC.md) ● [Русский](README_RU.md) ● [한국어](README_KR.md) ● [ภาษาไทย](README_TH.md) ● [Français](README_FR.md) ● [Italiano](README_IT.md) ● [日本語](README_JP.md) ● [Bahasa Indonesia](README_ID.md) ● [Português](README_PT.md) ● [Deutsch](README_DE.md)



**Textractor** (a.k.a. NextHooker) is an open-source x86/x64 video game text hooker for Windows 7+ (and Wine) based off of [ITHVNR](https://web.archive.org/web/20160202084144/http://www.hongfire.com/forum/showthread.php/438331-ITHVNR-ITH-with-the-VNR-engine).


Watch the [tutorial video](docs/TUTORIAL.md) for a quick rundown on using it.



## Download



Official stable releases of Textractor can be found [here](https://github.com/Artikash/Textractor/releases).


The last release of ITHVNR can be found [here](https://drive.google.com/open?id=13aHF4uIXWn-3YML_k2YCDWhtGgn5-tnO).


Experimental builds of Textractor (with debug info) from the latest source can be found [here](https://ci.appveyor.com/project/Artikash/textractor/history) in the 'Artifacts' section of each job.



## Features



- Highly extensible and customizable

- Auto hook many game engines (including some not supported by VNR!)

- Hook text using /H "hook" codes (most AGTH codes supported)

- Automatically search for possible hook codes



## Support



Let me know of any bugs, games that Textractor has trouble hooking, feature requests, or other suggestions by posting an issue.


If you have trouble hooking a game, please show me a way to freely download it or gift it to me on [Steam](https://steamcommunity.com/profiles/76561198097566313/).



## Extensions



See my [Example Extension project](https://github.com/Artikash/ExampleExtension) to see how to build an extension.


See the extensions folder for examples of what extensions can do. 



## Contributing



All contributions are appreciated! Please email me at [email protected] if you have any questions about the codebase.


You should use the standard process of making a pull request (fork, branch, commit changes, make PR from your branch to my master).


Contributing a translation is easy: [text.cpp](text.cpp) contains all of the text strings that you need to translate. Translations of this README or the tutorial video transcript are also welcome.



## Compiling

Before compiling Textractor, you need Qt version 5.13 and Visual Studio with CMake support.

Clone Textractor's source and initialize submodules with `git clone https://github.com/Artikash/Textractor.git` and `git submodule update --init`.

You should then be able to just open the source folder in Visual Studio and build.



## Project Architecture



The host injects texthook into the target process and connects to it via 2 pipe files.

texthook waits for the pipe to be connected, then injects a few instructions into any text outputting functions (e.g. TextOut, GetGlyphOutline) that cause their input to be sent through the pipe.


Additional information about hooks is exchanged via shared memory.


The text that the host receives through the pipe is then processed a little before being dispatched back to the GUI.


Finally, the GUI dispatches the text to extensions before displaying it.



## [Developers](docs/CREDITS.md)