RomTranslate Studio
Português

free open source test version

Translate retro games with AI, on your computer

RomTranslate Studio is a desktop app. You drop your game file onto its window. It works out which console the game is for, finds the dialogue, translates it with the AI you choose and writes everything to a copy. Your original file stays as it was.

Download Try it here

For macOS, Windows and Linux.

This is a test version. See what has been measured and what it cannot do yet.

Example with a made-up line: “Press START to light the lamp.” becomes “Aperte START para acender a lâmpada.”, in Brazilian Portuguese.

Made-up lines from the demo game just below, translated into Brazilian Portuguese.

Try it here, nothing to install

This is the app's real screen, running inside this page. The game (“Brisa e o Farol de Papel”) and its lines are made up, the answers are simulated, and nothing is sent anywhere.

How it works, in six steps

  1. You drop in the file

    The app recognises which console the game is for and shows the clues it used to decide.

  2. It finds the text

    It separates the text from the rest of the file. Anything that only looks like text is thrown away.

  3. The AI translates

    You pick the AI. It gets several lines at a time and is told how much room each one has.

  4. Every line is checked

    The app checks the size, the codes hidden in the text (for example, the spot where the player's name goes) and the letters the game can write. Lines that do not fit go back to the AI on their own. You can also fix any line by hand.

  5. The translation goes into a copy

    The app writes the translated lines to a working copy and checks the result. Your original file is never modified.

  6. You get a patch

    A small file that holds only what changed (in IPS or BPS format). You share the patch instead of the game.

What you need

Your own game file

The digital copy of the game, stored as a file on your computer. The app works with a file you already have. It does not download games, and this site does not offer any.

A computer

Running macOS, Windows or Linux. The app is installed on it and the work happens there.

An AI to translate

You pick one of these three options:

  • AI on your own computer (Ollama) free

    Ollama is a free program that runs the AI on your machine. Nothing leaves it. A small model struggles to keep lines short.

  • Your ChatGPT subscription the plan you already pay for

    No API key needed. It uses the Codex CLI, a program from OpenAI that you install, and you sign in from inside the app. Your plan's usage limit applies.

  • An API key billed per use

    An API key is a password an AI service gives you so programs can use your account. A Claude key works, and so does one from a service compatible with the OpenAI API. The service is the one that bills you. The app estimates the cost before the run and shows what was billed after.

With the online options, the app asks for your permission first and shows which text will be sent. Only the extracted lines go out, never the game file.

What makes it easier if you are not technical

  • No programming

    You do not write code or open a byte editor, the kind of program that shows a file number by number. The work is done with buttons. Some games still need manual adjustments: see the limits.

  • The game stays on your computer

    The game file stays on your machine. With an online AI, only the lines go out, and only with your permission.

  • The original is never changed

    The app works on a copy. The file you dropped in stays exactly the same.

  • A translation that does not fit goes back on its own

    Each line has limited room inside the game. If the translation is too long, the app asks the AI for a shorter one, without you doing anything.

  • What is not text stays out of the queue

    The game's internal names and pieces of the file that only look like text are not sent to the AI.

  • You can cancel

    You can stop the translation at any time. What has already been translated stays saved.

  • You end up with a patch

    A small file with just the translation. Anyone who has the original game applies the patch and gets the same result. You share it without distributing the game.

  • Free and open source

    MIT license. Anyone can read the code and see what the app does.

Consoles

All support is experimental. Each game stores its text in its own way, so there is no promise that any given game will work.

The last column matters because, in most cases, the translation has to fit in the room of the original line. Wii and Wii U are only recognised: the app cannot read their text yet.

Console Reads the text Writes the translation Translation longer than the original line
Game Boy Advance Yes Yes For part of the text
Nintendo DS Yes Yes For part of the text
NES Yes Yes No
Super Nintendo Yes Yes No
GameCube Yes Yes No
PlayStation 1 Yes Yes A little
PlayStation 2 Yes Yes No
PSP Yes Yes No
Wii and Wii U only recognised No No Does not apply

What has been measured so far

The app is in its testing phase (alpha). These numbers come from a single commercial Game Boy Advance game, from the maintainer's own cartridge. No data from that game is on this site or in the repository.

text segments translated and written back
10,705
messages whose control codes stayed identical, byte for byte
3,699 of 3,699
bytes changed outside message text
0
the game boots with the translation: intro and first dialogue checked in an emulator
Yes
AI lines that passed the check (ChatGPT, with automatic re-ask)
199 of 200
speed, with 4 requests to the AI at the same time
200 lines in 86 s

What that does not prove

  • Nobody has played that game to the end with the translation.
  • Only one real game has been through the whole process.
  • The version with accented letters needed manual work: the game's letter table and the text region were set by hand.

What it cannot do yet

  • Compressed text. Some games store their text compressed. The app counts those blocks but does not extract the text in them.
  • Japanese games. The app cannot yet read the Japanese text encoding most common in these games (Shift-JIS).
  • Fonts and drawn text. It does not edit the game's letters or text that is an image, such as title screens and some menus.
  • Size. Most of the text can only be as long as the original.
  • Cartridge games. Choosing the text region and the game's letter table is still manual work.

Download

The installers are not code-signed: this is a personal project, and certificates are paid. That is why your system complains the first time. Each block says what to do.

looks like your system

macOS

When the system complains

macOS says the app is damaged. That is its warning for an unsigned app.

  1. Open the downloaded file and drag the app to the Applications folder.
  2. Open the Terminal app, paste this line and press Enter: xattr -cr "/Applications/RomTranslate Studio.app"
  3. Open RomTranslate Studio.

Only the macOS installer has been opened and used by a person so far. The Windows and Linux ones are built automatically and still need someone to try them. If you do, tell us what happened on the project page. Every version is on the releases page.

Questions from people just arriving

What is this “game file” and where does it come from?

It is the digital copy of what is on a cartridge or a disc, stored as a file. Many people call it a ROM or an ISO. It comes from the copy of the game that you have. This site and the app do not offer games, do not download games and do not point to where to download them.

Is this allowed?

We are not lawyers, and this is not legal advice. What we can state is what the app does: it does not distribute games, it works only with the file you already have, and what gets shared is the patch, which holds the translation and not the game. The app's license covers only the app itself: it grants no rights over any game, trademark or translation of third-party work.

Do I need to know how to program?

No. The whole path is done with buttons in the app's window. For some cartridge games you still have to point out by hand where the text is and which letter table the game uses. That is not programming, but it takes work, and it is on the list of what the app cannot do on its own yet.

Does it work with any game?

No. All support is experimental. Each game stores its text in its own way, and there are cases the app cannot read yet: compressed text, Japanese games and text drawn as an image. So far, only one real game has been through the whole process.

Does the game leave my computer?

The game file, never. With the AI that runs on your computer, nothing leaves. With an online AI, only the extracted lines are sent, and the app asks for your permission first, showing which text will go out.

How much does it cost?

The app is free. The AI can be free (the one that runs on your computer), it can be the ChatGPT subscription you already pay for, or it can be an API key, billed per use by the service you choose.

How long does it take?

It depends on the AI. With a ChatGPT subscription, the measured pace was about 5 lines per second. At that pace, a game with about 9 thousand lines takes around half an hour.

Support the project

RomTranslate Studio is free and made in spare time. If it helped you, there are two ways to support it.

Star it on GitHub

It costs nothing and helps other people find the project.

Open the project on GitHub

Pix

Pix is Brazil's instant payment system. The key is a phone number:

13982286871