← All guides
Core Features

Game Text

2026-11-06 · 5 min read
On this page

    Game Text is for people wanting to read a visual novel or game in Japanese with each line translated as it comes up with the use of a text hooker (e.g. Textractor) instead of using the VN mode of OCR Capture. Your game will always be focused and pyontan does not hook itself to the game, pyontan reads from your text hooker of choice and locates the lines.

    Note: this guide is written both for people who don't know how to use text hookers as well as those who actually do know how to them

    Before you start

    • The game: ideally with the game in a window or borderless window
    • A text hooker: Either use your own or you can use the ones we have support for: LunaTranslator and Textractor which are both free

    Steps

    Open Game text

    • Alt+G, tray menu > Game text or from the Home window
    • There is an ⓘ icon which will lead to this guide and also has some simple information on connecting it to pyontan

    First time with a text hooker

    This provides information on both using the text hooker and setting one up, if you already know to to use one and have yours showing the game's lines? Skip to step 3.

    Luna Translator

    1. Download it from its GitHub releases page and unzip it somewhere. There's nothing to install: run LunaTranslator.exe
    2. Click on the settings icon in LunaTranslator starting window > Core Settings > Others > enable Network Service
    3. Start the game, then press run LunaTranslator and press the chain icon to pick a game, and choose the game's window/process
    4. A Select Text window will appear, find the one that contains the text of the game, and make sure "Show" is enabled for the entry that is the game's dialogue
    5. LunaTranslator does have its own translator you can disable if you wish, pyontan gives a breakdown of translations
    6. If the game isn't in the list for whatever reason, try repeating the above steps but run the LunaTranslator_admin.exe version

    Textractor

    1. Download from its GitHub releases page and unzip it. It comes as two folders. x86 and x64: x86 is for 32-bit games (mostly older visual novels) and x64 for 64-bit games. If you're unsure which a game is, try x86 first; if the game isn't in its list or fails use x64
    2. Start the game, then use Attach to game and pick the game in Textractor
    3. Click through a line or two in the game. The drop-down at the top fills with threads it found: pick the one that shows the dialogue. "Console" and "Clipboard" are Textractor's own, not the game
    4. Download the textractor_websocket extension (from its GitHub releases), place it in Textractor's according folder and in Textractor: Extensions > right-click the list > Add extension and pick the file that matches
    5. If the game isn't in the list at all try running Textractor as administrator

    When Neither finds the text

    • Some games need extra work: a hook code for that game, or a different setting in the hooker. That's specific to each game so search the game's name with "hook code" or "LunaTranslator" or you could ask the hooker's own communities
    • Try the other hooker. Some games may be easier to work with or exclusively work in one but not the other

    Connect it to pyontan

    Press the chip at the top (it says Clipboard at first) and pick one. The dot next to the title will fill once pyontan is successfully connected, hollow while it's waiting, and blinks as each line comes in. The order of which starts does not matter, pyontan will try until it finds the hooker/reconnect if the hooker restarts.

    • LunaTranslator: needs its network service on (from step 2). pyontan uses its default port, 2333
    • Textractor: needs the textractor_websocket extension (from step 2)
    • Clipboard: any hooker that copies each line works, including Textractor's Copy to Clipboard extension (on by default)
    • Other address...: any other hooker that sends lines over a WebSocket. Type its address in

    Read

    The hardest part for some people... just kidding!

    • Each new line with its translation and word cards, the same as Quick Translate. Click a word for its card
    • "◀" and "▶" step back and forward through the last 200 lines. A new line always jumps to the newest
    • With the window in front, "←" and "→" do the same, and Esc closes it

    Things worth knowing

    • The pin keeps the window on top of everything, including the game (on by default). Unpin it to let windows cover it
    • With Clipboard picked and the window open, Japanese you copy from any other app goes into Game text instead of the usual popup. Copies from a website still pop up as before
    • Settings > General > "Hide pyontan from screenshots and screen recordings" keeps the window out of streams and recordings while being visible on your own screen
    • Lines are translated using your translator from Settings. With pyontan AI each line is a use of the day's allowance

    Common Issues

    • Nothing shows: check the lines show in your hooker first. If they don't then it hasn't found the game's text yet
    • If receiving garbage, menu text or unrelated text: the hooker is on the wrong thread. Pick another one in it
    • The dot stays hollow with Textractor: the websocket extension isn't in the Textractor that matches the game (x86 or x64), or no lines have come through yet
    • Fullscreen games: pyontan can't show above exclusive fullscreen. If you want it on top, use windowed or borderless
    Related guides
    Ready to try pyontan?
    Free covers the basics. No card needed.
    Download