61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
# Textractor
|
|
|
|
[日本語](https://github.com/Artikash/Textractor/blob/master/README_JP.md)
|
|
|
|
## Overview
|
|
|
|
**Textractor** (a.k.a. NextHooker) is an open-source x86/x64 text hooker for Windows/Wine based off of [ITHVNR](http://www.hongfire.com/forum/showthread.php/438331-ITHVNR-ITH-with-the-VNR-engine).
|
|
|
|
|
|
|
|
## Downloads
|
|
|
|
Releases of Textractor can be found [here](https://github.com/Artikash/Textractor/releases).
|
|
|
|
Previous releases of ITHVNR can be found [here](https://github.com/mireado/ITHVNR/releases).
|
|
|
|
## Features
|
|
|
|
- Highly extensible
|
|
- Auto hook many game engines (including some not supported by VNR!)
|
|
- Hook text using /H "hook" codes (most AGTH codes supported)
|
|
- Extract text using /R "read" codes ([Guide](https://www.youtube.com/watch?v=AcEgjCoww5w))
|
|
|
|
## Extensions
|
|
|
|
See my [Example Extension project](https://github.com/Artikash/ExampleExtension) to see how to build an extension.<br>
|
|
See the extensions folder for examples of what extensions can do.
|
|
|
|
## Contributing
|
|
|
|
All contributions are appreciated! Please email (no, I'm not busy!) me at akashmozumdar@gmail.com if you have any questions about the codebase.<br>
|
|
You should use the standard process of making a pull request (fork, branch, commit changes, make PR from your branch to my master).
|
|
|
|
## Compiling
|
|
|
|
Before compiling *Textractor*, you should get Visual Studio with CMake support, as well as Qt version 5.11<br>
|
|
You should then be able to simply open the folder in Visual Studio, and build. Run Textractor.exe.
|
|
|
|
## Project Architecture
|
|
|
|
The host (see GUI/host folder) injects vnrhook.dll (created from the vnrhook folder) into the target process and connects to it via 2 pipe files.<br>
|
|
Host writes to hostPipe, vnrhook writes to hookPipe.<br>
|
|
vnrhook 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.<br>
|
|
Additional information about hooks is shared through a file view (a.k.a. section object) that is mapped to a reference to the TextHook class.<br>
|
|
The text that the host receives through the pipe is then processed a little before being dispatched back to the GUI.<br>
|
|
Finally, the GUI dispatches the text to extensions before displaying it.
|
|
|
|
## Developers
|
|
|
|
- Textractor creation/updating by [Me](https://github.com/Artikash) and [DoumanAsh](https://github.com/DoumanAsh)
|
|
- ITHVNR updating by [mireado](https://github.com/mireado) and [Eguni](https://github.com/Eguni)
|
|
- ITHVNR new GUI & VNR engine migration by [Stomp](http://www.hongfire.com/forum/member/325894-stomp)
|
|
- VNR engine making by [jichi](https://archive.is/prJwr)
|
|
- ITH updating by [Andys](https://github.com/AndyScull)
|
|
- ITH originally made by [kaosu](http://www.hongfire.com/forum/member/562651-kaosu)
|
|
- MinHook library made by [TsudaKageyu](https://github.com/TsudaKageyu)
|
|
|
|
## Special Thanks
|
|
|
|
- Everybody adding issues!
|