> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/advanced-features/ai-translation-service.md).

# AI Translation Service

The AI translation service translates the text of a game on the fly. When you press the hotkey, RetroArch takes a screenshot of the game, sends it to an online service that reads and translates the text, then shows the translation over the game.

{% hint style="info" %}

* The service only works with **RetroArch cores**.
* An **Internet connection** is needed.
* The translation is automatic: it can be approximate, and some text (stylized fonts, small text) may not be read correctly.
  {% endhint %}

## Enabling the translation

1. Open the [**MAIN MENU**](https://wiki.retrobat.org/navigation/main-menu.md) > **GAME SETTINGS**, **RETROARCH OPTIONS** group > **AI GAME TRANSLATION**.
2. Turn on **ENABLE AI TRANSLATION SERVICE**.
3. Choose your **TARGET LANGUAGE**: the language in which the text is translated. The language of the game is detected automatically.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FmpBq727zYYpztEQUuxRf%2Fimage.png?alt=media&amp;token=e624e1b2-6701-40db-a974-9a9cdacb0137" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="311.5">Option</th><th>Effect</th></tr></thead><tbody><tr><td><strong>ENABLE AI TRANSLATION SERVICE</strong></td><td>Enables the translation in RetroArch games.</td></tr><tr><td><strong>TARGET LANGUAGE</strong></td><td>Language of the translation.</td></tr><tr><td><strong>AI TRANSLATION SERVICE URL</strong></td><td>Address of the translation service. Leave it empty to use the default service (see below).</td></tr><tr><td><strong>PAUSE ON TRANSLATED SCREEN</strong></td><td>Pauses the game while the translation is shown.</td></tr></tbody></table>

## Translating during a game

| Action                                               | Controller        |
| ---------------------------------------------------- | ----------------- |
| Translate the screen                                 | HOTKEY + R1       |
| Hide the translation (and resume the game if paused) | HOTKEY + R1 again |

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fo8TjfqHeifuZj5OhjhGW%2Fimage.png?alt=media&amp;token=1972d68d-4e3e-4579-9e95-25ba19fddbb0" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you customized your hotkeys, use your own combination. See the Hotkeys page.
{% endhint %}

## Translation service

By default, RetroBat uses the **ZTranslate** service with a shared key: it works without any account. As this key is shared by many players, the service can be slow or unavailable at times.

To use your own key:

1. Create a free account on [ztranslate.net](https://ztranslate.net), then get your API key in your profile.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FaVp4WKio8KqKUuMameBQ%2Fimage.png?alt=media&amp;token=1f480874-7c58-40d7-82b5-3877e4a16c4a" alt=""><figcaption></figcaption></figure></div>

2. In **AI TRANSLATION SERVICE URL**, enter: `http://ztranslate.net/service?api_key=YOUR_KEY` (replace `YOUR_KEY` with your key).

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FcJ9wfsC4oryj2ZqrkICW%2Fimage.png?alt=media&amp;token=54b11b6b-d2a1-476e-ae7d-150763324c2a" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Write the address with `http://`, not `https://`. RetroBat adds the language and display settings at the end of the address by itself: do not add them.
{% endhint %}

## Common problems

<table><thead><tr><th width="350.25">Problem</th><th>Solution</th></tr></thead><tbody><tr><td>Nothing happens when pressing HOTKEY + R1</td><td>Check that the service is enabled and that the game uses a RetroArch core. Check your Internet connection.</td></tr><tr><td>The translation takes long or never appears</td><td>The shared service may be overloaded: try again later, or use your own key.</td></tr><tr><td>The translation is wrong or incomplete</td><td>The text could not be read correctly (stylized font, small text). Try on a screen with clearer text.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/advanced-features/ai-translation-service.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
