Skip to content

Agent Guide

This guide walks you through setting up and using Agent, a universal script-based text hooker powered by FRIDA. Agent is designed for extracting text from visual novels and games across various platforms including PC games, emulators, and Unity games. Despite the simple UI, Agent is a powerful tool for hooking games that might not work with textractor.

Agent window

Requirements

  • Agent (Latest release)
  • Target game or application
  • Internet connection (for script updates)

Installation

Download and Setup

  1. Download Agent: Visit the releases page and download the latest version
  2. Extract: Unzip the downloaded file to a folder of your choice

First Launch

  1. Run agent.exe to start the GUI
  2. Agent will automatically download and sync scripts from the scripts repository
  3. Under the settings tab, ensure that "Machine Translate" is disabled and that either the websocket server or clipboard output is enabled

Agent settings

Usage

Basic Operation

  1. Select Target: To select a target, you can supply a file directory to an exe file or you can more simply click and drag the target icon on to your target game. Clicking the dropdown menu next to the target icon and selecting "Create Process" will bring up a file picker allowing you to select a target. Agent target icon Agent target icon drag
  2. Apply Script: In the window next to the "<>" icon, you can select the appropriate script for your game. You can search by name or platform. Clicking on the "<>" icon will bring up a file picker, allowing you to add a custom script
  3. Text Extraction: Press the "Attach" button and text will be hooked and displayed in real-time

Command Line Support

Agent also supports command-line operation for advanced users:

agent.exe [options] [target]

Script Management

Automatic Updates

  • Scripts are automatically synced from the official repository
  • New scripts and updates are downloaded automatically

Custom Scripts

  • User scripts are stored in the data/scripts folder
  • You can add custom scripts for unsupported games
  • Scripts use JavaScript

Additional Resources