The JMRI Manual
Download 3.0
Installing JMRI
Starting JMRI Operations
Using JMRI Operations

Getting Started with DecoderPro®

How do I set up my preferences?


Back to Index

Click on the Edit menu and then Preferences... option in the screen below, which opens the Preferences window. (This window may open automatically the first time you run the program.)

As a first time user the most important information is the Connections screen where you describe how the computer will talk to the command station. Most of rest you can leave at the initial or “default” settings until you find a need to change things to suit your fancy.

Most importantly, you must click to finalize your settings and then re-start the program to have them take effect.

The Preferences window provides access to the basic configuration information to connect your computer to your DCC system. You will be using that system to actually program and operate trains equipped with DCC decoders.

The window is split into two panes, on the left side is a list of preference groups that may be set. Clicking on one of the items opens the options that may be set in the right side pane. No selection have been made


Connections Allows you to select the system connection that you are using for controlling DCC and the connection to your computer.
Defaults Shows system default settings
File Locations Set default location for saving User files and Script Files
Start Up Allows you to set Actions, Buttons, Files and Scripts that run at Start Up
Display Allows you to select your computer display mode
Messages Set default actions for system message when displayed
Roster Allows you to set your default Programmer and roster location
Throttle Allows you to set up you Throttle preferences
Wi Throttle Allows you to set up a Wi Throttle settings
JSON Server Opens JSON Server Prefence settings pane
WebServer Sets up the JMRI WebServer

Now we will set up preferences for the JMRI environment with your command station.

I am using a Digitrax Super Chief Command Station (radio) interfaced to the computer via loconet, PR3 (MS100 mode) and USB port. I keep master roster on the System Drive.;

Connections Pane (TABS are configured to the system your selected)

Now select Connections and connection options display in right pane

System manufacturer: Drop-down list with all the supported DCC manufacturers, select the manufacturer of your system.
System connection: Drop-down list with all of the supported DCC system interfaces supportted by the manufacturer that you selected, select the interface that you are using.
Settings: Serial Port: Drop-down list to select the serial port to which your DCC interface is connected. If you do not know, check your system hardware configuration manual. A second drop-down list may include a selection if there are more than one possibility. possibilityDrop-down list to select the serial port to which your DCC interface is connected. If you do not know, check your system hardware configuration manual. A second drop-down list may include a selection if there are more than one possibility
Command station type: Drop-down list to select the command station type that JMRI will be using to send your DCC commands.
Connection prefix Include the prefix for your connection, in the case shown the "L" is default
Connection name Should default to the connection used

Additional Connection Settings, if checked:

will disable all the connection settings.

will delete all the connection settings.


Defaults Pane

Shows the default settings which will depend upon the system used.


File locations Pane

User Files Location Select the location for your user files on your system
Jython Script Location Set the location of Jython Script files


Start Up Pane

Actions TAB to set up a Startup action actions
Buttons TAB to the Splash Screen buttons
Files TAB that you want to load at startup files
Scripts TAB to load at startup scripts

You may add as many items as you want to open on start up. Example of Actions


removes the item from the Start Up sequence. All of the panes are of the same format.


Display Panes

GUI Pane


Select your preferred appearane for buttons, menus, etc. Metal
Windows Classic
Select font size in points
select font size
Use non-standard release event for mouse click?

Locale Pane


Drop-down list to select your location and language

Console Pane

Display settings for the JMRI system console.


Messages Panes

TABS and selections can be used to set how and when messages are displayed.


Roster Panes

Programmer pane

Used to set the preferred decoder programmer.

Roster Pane

You may set the default location of the locomotive roster and the default owners name.


Throttle Pane

Select throttle startup conditions, shown are defaults, but you may change the settings.


WiThrottle Pane

This pane allows WiThottle users to customize the setup.


JSON Server Pane

MinServer Pane

Use this pane to setup MinServer if you are using it.


Before you exit the preferences, Click on button to save all your selections.

You must restart DecoderPro for preferences to take effect


Back to Index