Tataru Helper v1.0.3

Moves the project to its own repository. Nothing about how it works changes.

If you are on 1.0.2 or older, take this update. The address an installed
copy asks for its next version is baked into the build, and older builds ask
xDarkOne/TataruHelper. This release is published in both places so those
copies can find it; after it, updates come from
NightlyRevenger/TataruHelper
and the old repository stops being used. Skip it and your copy will quietly
stop seeing new versions.

Also fixed

• The "Download Setup.exe" button on the front page was a 404. Velopack
  names the installer TataruHelper-stable-Setup.exe, and every link and
  download badge still said Setup.exe.

---

Maintained by xDarkOne. Originally created by
NightlyRevenger. MIT licensed.

Tataru Helper v1.0.2

Languages — the ones you translate into, and the ones the interface is
written in.

Translation engines

Google Translate now offers 250 languages instead of 66, and Yandex 119
instead of 94. Neither list had gone stale; they had simply stopped growing
while the services did not. The lists are taken from the services themselves
and were checked by translating a line into a sample of the new ones — Amharic,
Aymara, Bhojpuri, Khmer, Lao, Maori and Zulu on Google; Ossetian, Yakut,
Chuvash, Chechen, Bashkir, Komi, Erzya and Brazilian Portuguese on Yandex.

Three Yandex languages carried a stray space in their name — "Afrikaans " never
matched the "Afrikaans" the language detector produces, so automatic detection
could not select them.

DeepL stays at 30. Its web interface and its documentation both offer around
113, but the endpoint this talks to serves the classic set and answers nothing
for the rest: Russian and Japanese come back translated, Hebrew and Vietnamese
come back empty. Offering them would have meant choosing a language and
silently getting nothing.

Interface

The Russian interface was missing 120 strings. Everything added recently — the
whole XIV Rus Translation section, the daily check and what it reports,
resetting settings, the Gemini model box, the About page — showed in English.
All of it is translated now, and the English catalogue has caught up with what
the application actually asks for.

---

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

Tataru Helper v1.0.1

Mostly about the application explaining itself: a log that exists, settings
named after what they do, and only ever one copy running.

Fixed

• An installed copy wrote no log at all. The file names were relative, so
  they resolved against the working directory — and an installed copy is
  always started with elevation, which makes that C:\WINDOWS\system32. Every
  line the application prints to explain itself was visible only to somebody
  running it out of a build folder, so asking for a log got nothing back. The
  log now lives in %APPDATA%\TataruHelper\Log.txt, beside the settings, where
  an update does not replace it. Please attach it to bug reports.
• Two copies could run at once, translating the same game twice and both
  writing the same settings. Whether this is the only copy is now settled
  before a window is built rather than inside the window's constructor, where
  the answer arrived too late to stop anything.
• A chat window could appear twice in the list under the same number, with
  only the first reachable — selecting and deleting both go by number and stop
  at the first match. Two additions could each find a number free before either
  took it; the refusal now sits at the insertion, where the check and the add
  cannot be pulled apart.

Settings

• Literary translation is now called XIV Rus Translation, which is what
  it is and what everything around it already said.
• Install new translations by themselves is now Update translations
  automatically.
• Mark machine translation moved under Translate speaker names: both
  are about how a line is presented.
• Paragraph settings moved out from under Messages in container, which it
  has nothing to do with, and under Overlay behavior, which is the rest of
  how the overlay lays text out.
• About names the repository plainly and carries the project's Patreon.

Translation

• Gemini asks for gemini-3.6-flash by default rather than a model two
  generations older. The box on the General page still overrides it.

---

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

Tataru Helper v1.0.0

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 info → Run 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.