Skip to Main Content

Principal Sponsors

The William and Flora Hewlett Foundation
The Hewlett Logo

Makes grants to address the most serious social and environmental problems facing society, where risk capital, responsibly invested, may make a difference over time.
The NSF LogoNational Science Foundation

An independent federal agency created by Congress in 1950 to promote the progress of science.

Other Sponsors Logo

PhET Translation Utility (beta)

This is a beta version of the PhET Translation Utility. PLEASE READ THIS PAGE COMPLETELY.

The Translation Utility can be used to create a translation for a new language, or to edit an existing translation. In both cases, the instructions are the same.

General instructions

  1. Download translation-utility.jar to your computer.
  2. Go to the PhET website and download the JAR file for the simulation that you want to translate (press the "Run Offline" button on a simulation page).
  3. Double-click on translation-utility.jar to start the Translation Utility.
  4. Enter the full path name of the simulation's JAR file.
  5. Select the language that you're translating from the option menu. If your language is not listed in the menu, contact phethelp@colorado.edu to request a custom language code. When you receive your custom language code, select CUSTOM from the option menu (the last option in the menu) and enter your customer language code in the text box that appears.
  6. Press the "Continue" button.
  7. Enter the translated strings in the right-most column of text fields.
  8. Press the "Test" button to run the simulation with the translated strings.
  9. Use the "Save" and "Load" buttons to save and load your work.
  10. Press the "Submit to PhET" button when you've finished your translations. This saves the translations as a Java properties file. Note the properties file name and email address shown in the dialog.
  11. Email the translation file to PhET.

Example Usage

This example shows how to translate "Models of the Hydrogen Atom" to French.

  1. Download translation-utility.jar to your computer.
  2. Go here and click the "Run Offline" button. This will download hydrogen-atom.jar.
  3. Double-click on translation-utility.jar to start the Translation Utility.
  4. Press the "Browse" button and locate hydrogen-atom.jar that you downloaded.
  5. Select "French (fr) from the language option menu.
  6. Press the "Continue" button.
  7. Enter the French translations in the right-most column of text fields. For example, for hydrogen-atom.name, enter "My French Title".
  8. Press the "Test" button to run the simulation with the translated strings. You'll see the simulation start with "My French Title" in the progress dialog.
  9. Save your work to a file using the "Save" button. You can exit the Translation Utility and load that file later using the "Load" button.
  10. Press the "Submit to PhET" button. Your translations will be saved in hydrogen-atom-strings_fr.properties.
  11. Email hydrogen-atom-strings_fr.properties to phethelp@colorado.edu

Caveats

  • The Translation Utility works only with Java-based simulations. PhET's Flash-based simulations do not currently support translation. PhET expects to support translation of our Flash-based simulations in a future release.
  • Some strings that appear in a simulation are part of a library of "common components" that are used in all PhET simulations. These "common strings" are not yet translatable via the Translation Utility. Examples of common strings include: the "File" menu, the "Help" menu, the Play/Pause/Step buttons that controls the clock. PhET expects to makes common strings translatable in a future release.
  • Some of the strings that appear in the Translation Utility may not appear in the simulation that you are translating. This is because similar simulations (eg, the variants of Circuit Construction Kit) share one translation file. If a string does not appear in the simulation that you're translating, feel free to leave it blank.

Mailing List

Join the PhET Translation Utility mailing list by visiting https://lists.sourceforge.net/lists/listinfo/phet-translation.

Bug Reports

Report bugs to phethelp@colorado.edu. Please include the version number (shown in the title bar) in your correspondence.

Login / Register