Tutorial:How to translate Cemu UI

Tutorial

• Download and install your favorite PO editing tool, e.g. Poedit.
• Choose the language you want to translate and either:
  • fetch the latest PO file for an existing language from here and open it; or
  • create a new translation and use the English cemu.pot file as source
• Submit your finished work (just the PO file) by either using a GitHub pull request (learn about them here), or by sending it in Discord to one of the users listed below.

General translation guidelines

• Don't overtranslate technical terms. Translate English technical terms (e.g. stack, v-sync, upscaling etc.) into your language only if there's a commonly used equivalent word. In a nutshell: avoid literal translations that don't mean anything. If in doubt, use your country's Wikipedia for reference or check how the same word has been translated in other programs (Microsoft Terminology Database is a great place where you can look for this!). If both the original and the translated term are used in your language, stick to the most commonly used one.
• Keep your work updated, if you can. Cemu is an actively mantained project and updates often brings new strings and/or remove some old ones. Therefore you are encouraged to update your translation whenever the English .pot file is updated by Cemu developers. In Poedit, you can do so by clicking Catalogue -> Update from POT file and selecting the new .pot. No hurry needed :)
• Ampersands within words are not mistakes. They are positioned just before the letter that is used to determine the keyboard shortcut for the menu entry corresponding to that string. You are free to change their position if you find appropriate to do so. (Just don't add them in strings in which they are not present!)
• Disagree with a translation made by another user? There are GitHub issues to give contributors the opportunity to discuss their opinions and reach a conclusion. Just use them if you feel like it.

Testing/Using new languages

If you want to test your translation or use an existing translation from the repository/another user, simply create the folder with the correct language code in "cemu/resources" and insert the compiled "cemu.mo" file.

Supported language codes can be found here: language codes.

You can use Poedit to compile a MO file:

1. Open the PO
2. Use the menu bar: File -> Compile to MO...
3. Select the correct folder as destination

Repository mantainers

These Discord users have write access to the GitHub repository and can update files. If you're not a member of our Discord server yet, you can join us here.

• Petergov#3780
• Fs00#9393