DecoderPro User Guide - Updating Decoder Definitions

Many people have contributed decoder definition files to DecoderPro. Between new releases, new files will be created that you might want to use. New ones can usually be found either on the JMRI web site or in the files area of the jmriusers Yahoo group.

To use these xml files you need to download and install them.

On Windows Systems

• Go to the files menu where the decoder.XML file is located and right click on the file.

  (Don't double click or you will open the file rather than saving it.)

• Choose the menu selection "Save as" or "Save target as". After you choose this menu item a window will pop up and ask you for a location that you want to save the file.

  You can either type in a directory name or click the browse button. To save a step I suggest that you choose browse and then select the "program files/JMRI/XML/Decoders" directory.

  If you save the file to any other directory, or the desktop you will have to copy the file over to the correct directory using the copy and paste in Windows Explorer. It's easier to just save it in the correct directory in the first place.

• Once the file is in the decoders directory you need to open Decoder Pro and choose the Debug menu item. It's one of the menu items on the top horizontal menu on the opening screen.
• From the drop down debug menu choose the item that says "rebuild (or recreate) decoder index". After you have rebuilt the decoder index the decoder should show up.

  The key to make this work is that the downloaded XML file needs to be in the JMRI/XML/decoders directory, otherwise Decoder Pro doesn't know that it is there, and won't see it when you rebuild the decoder index.

MAC Classic

• If you want to down load one of these "option and click" on it.
• Then copy the file into the JMRI/xml/decoder folder.
• Once the file is moved, rebuild the decoder index through use of the "Recreate Decoder Index" found under the Debug menu.