Language Translation

From Mumble Wiki
Revision as of 16:03, 5 February 2015 by DD0T (talk | contribs) (Fixing errors in the original English strings)
Jump to: navigation, search

As of March 2014 Mumble supports 18 different languages. As more people get to know and use Mumble, versions in their native languages become more and more important.

Translating is one way to contribute to the Mumble project, and we’re thankful for any help!

Since we moved from a manual process to the hosted Transifex in 2014 the process of translating has become a lot easier.

The editor is usable with any standard webbrowser:
Transifex working ui.png

Translation process

Although there is an adequately high quality requirement for release-ready translations, we appreciate any contributions. If you want to make sure a language ships you will have to become a coordinator, which is probably a bit more time intensive than just translating strings as you will have to make sure translations are consistent in their entirety, and that they meet a certain quality level. You do not need ANY coding skills in order to translate Mumble however, just time and patience.

In order to package a translation in a stable release we require a trusted translator (which you could become) that translated/reviewed all translations of that language. We appreciate any translation contributions from everyone but require this additional review step to make sure no bad manner or wrong translations go into one of our stable releases.

Getting an Account on Transifex

If you do not have a Transifex account yet you need to create a contributor account.

Transifex register.png

You will receive an email with an account activation link. After account activation, log in, and open the Transifex Mumble project page at

If the language you want to translate into is already listed you will want to join that translation team. If your desired language is not listed yet you can request a new language as well.
Mumble project.png


Click on the language you want to update/improve, then on "Join team" in order to be able to submit translations:
Transifex join button.png

Confirm the popup:
Popup join language team.png

You get a confirmation message:
Transifex team joined.png

Now you can click on the entry "mumble_en.ts":
Transifex open lang popup.png

Then click on "Translate now" to start your work:
Transifex translation popup.png

You may want to continue with the Introduction to the Transifex user interface.

Requesting a new language

You don't need to do the complete translation; just do what you can. Once you started a new language others can help to extend and finish it.

Click on "Request language" and select your desired language, for example Esperanto:
Mumble request esperanto.png

Once the language has been added you can start translating.

Working With The Transifex User Interface

This is your User Interface:
Transifex working ui.png

Transifex provides a good documentation for the user interface.

Testing The Results (intended for develeopers only)

To test the resulting translation click on the entry "mumble_en.ts" and then "Download for use" in the popup:
Popup download ts file.png

In order for the Mumble client to use the translations the ts file will have to be converted to a qm file. Open the ts file you downloaded with Qt Linguist, and then “Release as” to save a qm file, naming it mumble_<lang-shorthand>.qm.

Go to your Mumble folder and put the mumble_*.qm file inside of it. Now start Mumble and make sure that your language is set in the user interface section of the Mumble configuration. The language should be displayed in Mumble after you restart the client.

Fixing errors in the original English strings

If you find a typo or an error in the original English text please report it to our issue tracker and we will fix it. If you feel comfortable around source code and git you can also directly fix the issue in the source and provide us with a pull request on github. Your commit for that should only contain the fix and should not touch the .ts files. If you want you can run scripts/ to generate a commit to update the mumble_en.ts file from the Mumble sources but we can do that for you. No other .ts files need to be changed as our transifex workflow will have them automatically updated by our transifex bot as soon as it picks up on the update.

Installer translations

With the guide above you can translate the client itself. For the windows platform mumble has an installer which has to be independently translated. Unfortunately, because of technical reasons this is currently a separate process. For information on how to translate the installer see Windows installers translations.