Text Hooker Web Companion (AGTH / Textractor UI)

A lightweight, focus-safe text-hooking interface designed for playing Japanese games (visual novels, RPGs) alongside text hookers and browser extensions like 10ten Japanese Reader.

---

How It Works

1. AutoIt Script (agth.au3) runs in the background, continuously monitoring your clipboard for new lines from your text hooker (e.g., AGTH, Textractor).
2. When the clipboard updates, it writes the text instantly to a local file (agth.txt) using UTF-8 encoding.
3. An invisible Python local server serves your frontend.
4. index.html uses background JavaScript polling to check for updates every second, updating the display live without ever stealing focus from your game.

---

Features

• Zero Focus Stealing: Your game stays active, and background music keeps playing. No disruptive window-switching or forced focus commands.
• Browser Extension Friendly: Running on localhost bypasses local file (file:///) security restrictions, making tools like the 10ten Japanese Reader extension work flawlessly.
• Auto-Updates: Changes reflect instantly in the browser without manual page reloads.
• Clean Reader Layout: Full-window layout with enlarged, readable text and spellcheck="false" enabled to prevent red squiggly underlines under Japanese text.
• Automatic Cleanup: The AutoIt script automatically spins up the Python server on launch and shuts it down cleanly when closed.

---

File Structure

Place these three files in the same folder on your computer:

agth-companion/
├── agth.au3           # The background AutoIt monitor & server launcher
├── index.html         # The responsive browser UI with live polling
└── agth.txt           # Auto-generated text cache (handled by script)

Setup & Usage

Prerequisites

• AutoIt (to run the script)
• Python (for the local server launcher)
• Firefox (or any modern web browser) with your dictionary extension installed.

Getting Started

1. Save agth.au3 and index.html into a dedicated folder (e.g., agth).
2. Run agth.au3 using AutoIt. (This starts an invisible Python HTTP server on port 8000).
3. Open Firefox and navigate to:

   http://localhost:8000/