Troubleshooting

AI translation errors

  • «Insufficient words» / 402 — buy a pack in your poagent.net account.
  • «Key not found» / 404 — verify the POA-… key in Settings → License (case and hyphens matter).
  • «ai_not_configured» — the administrator has not configured the model yet; come back later or use your own profile.
  • HTTP 0 / timeout — network is unreachable or the request took too long. The app retries up to 2 times; check your connection/firewall.
  • 429 — rate limit hit; retry in a couple of minutes.
  • «Model reply is not JSON» — the model returned garbage; the app retries and splits the batch if needed.

File issues

  • «Parse error» — the file is corrupted or is not gettext. Check that it opens in a text editor and starts with msgid "".
  • Cyrillic looks garbled — the file is not UTF-8; re-encode it (Notepad++ → Encoding → UTF-8) and reopen.
  • Cannot save — make sure the folder is writable and has free disk space.

Crash recovery

If the app closed with unsaved edits: the next launch offers to restore the last session draft. Accept it — the text returns with all AI drafts. The draft is kept for 24 hours.

Log

Everything is written to the log at the bottom of the window and to Data\log.txt. When contacting support, attach Data\log.txt — it has exact errors and timestamps.

Updates

The app silently checks for updates on launch (once a day); a banner with a download link appears in the footer when a new version exists. Updates are optional and never wipe data (Data\ is untouched).

← Docs