DecoderPro® Manual
Setup JMRI
Getting Started
Using DecoderPro
DecoderPro Programming Modes
The Basic Programmer
The Comprehensive Programmer
Advanced Features
DecoderPro® Main Window
Error Messages

DecoderPro® Main Window

Settings Menu - Roster Groups

The Roster Groups function allows you to take your entire roster and categorize it. At home you might want to break it down by diesel vs. steam, or by railroad. At a club it would be handy to have categories by member name in addition to any other category you might think of. A roster entry can be associated with more than one group. Again in a club environment, a roster entry could be associated with the Steam, Union Pacific and John Smith groups all at the same time. There is always one group present and it is called Global. All the roster entries are in the Global Group.

Hide/Show Roster Groups

The Hide/Show Roster Groups control is used to toggle the Roster Groups Display Panel on/off in the area highlighted in pink. This must first be activated by clicking on the Settings tab and then clicking on Hide/Show Roster Groups. If the Roster Groups panel does not display when you click on the setting, try to grab the frame on the left side of the area and drag it open (make sure the Hide/Show is in the correct state.)

The panel width may be sized by dragging the frame as indicated by the red arrows. The small arrowheads will allow you to close the panel or open the panel
roster group
The Roster Groups will be listed in the Roster Group panel as we create them.

Create Roster Group

Use Create Roster Group to define any other groups you wish. From the Settings menu Create Roster Group opens the New Roster Group dialog. This same New Roster Group dialog may be opened using the + button above.

Roster groups add group Creates a Roster Groupnew group

The OK button will Add the Roster Group to the list in the panel and to the drop-down list on Main window toolbar.

You can now add locomotives to the Groups either by dragging from the locomotive roster list or using the Table Associate, discussed later.

menu button roster group menu
Opens context menu for Roster Groups
Open in New Window
A window may be opened for each group if you wish.
Opens Save dialog box allowing you to save the group to a file.

Rename Roster Group

rename roster

Duplicate Roster Group

roster group duplicate

Delete Roster Group

delete roster group

Roster Group Table Association

Once the groups are named, then you "associate" the roster entries with their group. This can be done by using the Table Association selection. At the top of the table you select the group you wish the roster entries to be associated with, then the roster entries that you want to associate with that group.


Select Roster Group: the roster group that you want to add entries to.

The table shows all the engines in your roster.

In the right column, Include... select the entries that you wish to add to the Roster Group, click individually to select a single item, hold the shift key down to select a range of items, hold the CNTRL key down to randomly select items. Close the Table and the entries will be added to the group.

Once the associations have been made, then you can select the Active Roster Group. Once this is done then the Print and Print Summary actions will show only the roster entries associated with that group. As an example you could select the Group Santa Fe and only the roster entries in this Roster Group will be printed. The printout does not currently show the active group in the header. The active group will also influence any drop down box which has a list of entries in it, such as Throttle, edit entry, copy, etc. Also, when adding a new roster entry it will automatically be associated with the currently active group, so it is good practice when finishing working with a group to return the active group to Global.

Restoring Roster to include all Engines

To return your roster to show all engines, Select Roster Group to All Entries, or Global. Then you may be certain that you are working with all engines in your roster.

Disassociation of Roster Entry to Group

To disassociate a roster entry to a Roster Group, open Roster Group Table and uncheck roster selection and save new Group by closing the Roster Group Table.