npm.io
2.0.1 • Published 7 years ago

textractor-wrapper

Licence
MIT
Version
2.0.1
Deps
2
Size
28 kB
Vulns
0
Weekly
0
Stars
6

node-textractor

Textractor wrapper for Node.js.

Textractor (a.k.a. NextHooker) is an open-source x86/x64 text hooker for Windows/Wine based off of ITHVNR.

Requirements

  • Textractor v4.3.0 and above

Example

const Textractor = require("textractor").Textractor;

let t = new Textractor("X:/path/to/TextractorCLI.exe");

t.on("output", output => {
  console.log(`[${output.handle}]: ${output.text}`);
});
t.start();
t.attach(PID);

API

Textractor(path: string)

The constructor.

Params
  • path - Path to TextractorCLI.exe
start(): void

Start Textractor process.

attach(pid: number): void

Attach text hooker to a specific process.

Params
  • pid - Process ID
Throws
  • RangeError if pid is invalid
  • ReferenceError if Textractor process is not started
detach(pid: number): void

Detach text hooker to a specific process.

Params
  • pid - Process ID
Throws
  • ReferenceError if the process has not been attached
hook(pid: number, code: string): void

Inject a hook into a specific process.

Supports /H hook code and /R read code.

Params
  • pid - Process ID
Throws
  • ReferenceError if Textractor process is not started
  • ReferenceError if the process has not been attached
  • SyntaxError if code is invalid
on(event: "output", listener: (output: TextOutputObject) => void): this

Specify callback function when text outputs.

Params
  • event - Must be "output"
  • listener - The callback function
TextOutputObject
{
  handle: number; // hook index
  pid: number; // process ID
  addr: number; // hook address
  ctx: number; // hook context
  ctx2: number; // hook context 2
  name: string; // hook name
  code: string; // hook code
  text: string; // output text
}
exec(command: string): void

Execute a command manually.

Params
  • command - The command to execute
Throws
  • ReferenceError if Textractor process is not started
stop(): void

Stop Textractor process.

License

MIT

Keywords