Skip to content

Tataru Helper v1.0.0

Choose a tag to compare

@xDarkOne xDarkOne released this 09 Aug 15:47
· 7 commits to master since this release

First release of this fork, built on .NET 10 and shipping as a self-contained
application — no runtime to install.

Install: download TataruHelper-stable-Setup.exe below and run it. If
SmartScreen appears, choose More infoRun anyway; the installer is not
code-signed. There is also a portable build if you would rather not install.

Updates are checked automatically and installed on restart. Your settings and
translations live in %APPDATA%\TataruHelper and survive both updates and
uninstalling.

Hand-made translations

Dialogue is looked up in the XIV Rus Translation
project before any engine is asked, so most story lines appear instantly and
read the way a person wrote them. The index ships inside the installer —
201,730 lines — so a fresh install translates from the first line and works
without a network.

  • The index is keyed on the language your game client is set to, read from
    FFXIV.cfg, not on anything chosen in the application. English, German,
    French and Japanese clients are all supported.
  • Tataru Helper asks the translation project once a day whether it has written
    anything new and says so. Fetching it stays your decision unless you turn on
    Install new translations by themselves.
  • The XIV Rus Translation section hides itself when you are reading in the
    language the game is already in, because there is then nothing to look up.

Several classes of parsing fault were found and fixed by comparing lines that
came out machine-translated against what the project actually held for them:

  • The player's name is written into a line two ways, and only one was
    recognised — so the game addressing you by name was exactly the case that
    fell through to an engine.
  • A hyphen the game will not break a line at is written as its own tag. It was
    being deleted, so Kan-E-Senna, Radz-at-Han, Toto-Rak, Heaven-on-High and
    4,267 other lines could never match what was on screen.
  • Rows nobody had translated came back carrying the translation tool's row
    number, and were stored as though somebody had written them.
  • Sheets are read as XML rather than matched with an expression, which ends a
    fault that had filed 1,281 rows' text under the wrong row's number.

Translation engines

Google, Yandex, DeepL, Azure, Google Cloud, OpenAI, Gemini, DeepSeek and
YandexGPT. Keys are stored encrypted per user, never in the settings file.

Reading the game

  • Dialogue and cutscene subtitles are read as they appear, without waiting for
    the chat log, and the chat-log copy of the same line is dropped so nothing is
    shown twice.
  • A new chat window listens to story dialogue whichever way it arrives, so
    turning realtime reading off still leaves you with translated dialogue.
  • The speaker's name can be shown in your reading language, using the
    hand-made spelling where there is one.

Other

  • Settings can be put back to what a fresh installation has, from the General
    page.
  • Only one copy of the application runs at a time; starting a second one raises
    the window you already have.
  • The log lives in %APPDATA%\TataruHelper\Log.txt. Please attach it to any
    bug report.

A fork of the original TataruHelper
by NightlyRevenger. MIT licensed.