How to Translate OsmAnd - We Need Your Assistance!

In this article

We really appreciate your help translating OsmAnd! Providing display text translations is not very complicated, the preferred way to provide string translations is described here: OsmAnd @ Hosted Weblate.

  • If a language you would like to help translating into is not yet listetd there, please open an issue here (requires a github account).
  • Existing language files could also be modified by editing the respective strings.xml file directly in our code via github mechanisms, but this is not the preferred way.
  • Just for reference: master strings are kept in the American English strings.xml file. The string data for the map data extractor is in the swing_messages_{language}.properties files in the DataExtractionOsm (NOTE Hardy: link is broken!) project.

Thank you for your help !

Some Frequent Questions and Answers:

Q1: Which strings should I translate?

The Weblate tool is self explanatory. Only if ypu try to edit files directly:

  • In strings.xml, strings look like <string name="shared_string_save_as_gpx">Save as GPX track</string>. Translate only the Save route as GPX track part.
  • In swing_messages.properties, strings look like IndexCreator.INDEX_CITIES=Indexing cities.... Translate only the right part Indexing cities....

Q2: I don't want to create in Weblate or github, can I simply post you the file?

Yes, you can email the file, but please try the preferred ways, it is easy.

Q3: How should I check what has changed in the English strings.xml ?

Please use Weblate as described above, it will show you all changes. If you want to check the source manually vs. your file: New strings are usually added at the top of the master language resource file. You can download it and use some utility like pspad or vim to compare them. You can also use blame or the file history on github to view the last modifications.

What languages will be included in OsmAnd ?

Dear translators,

Thank you all very much for your efforts to complete our display language translations, and also to localize OsmAnd in more and more languages on Weblate!

Please note the following: I am happy to include in OsmAnd's display language selection menu any new language with >10% translation rate, (will mark it as "incomplete" until it reaches ~80%). Please post an issue with OsmAnd if you need this done, I only sporadically watch these figures on Weblate.

Unfortunately, languages featuring 3-letter ISO 639-2 codes currently seem to have issues in Android, see e.g. https://code.google.com/p/android/issues/detail?id=49120 https://code.google.com/p/android/issues/detail?id=106574
This means that, unfortunately, any such language may not display in the OsmAnd menus on your device. (This issue only affects the language used in the app menus, not in the map, of course.)

Thanks,
Dr. Hardy Mueller

Did this doc help you?

Privacy policy

Help us make these docs great!

All OsmAnd docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.