Download and install JMRI®
JMRI Setup and Installation
JMRI environments...
Release Notes
Supported Hardware
Devices, command stations, networks, and protocols:
Source Code

JMRI Help:

Contents Index
Glossary FAQ

Donate to JMRI Donate to

Release Notes for JMRI 4.14 release

Date: December 23, 2018

From: Bob Jacobsen

Subject: Production Release 4.14 of JMRI/DecoderPro is available for download.

We are very pleased to announce that the 4.13 series of JMRI test releases has resulted in a version that's good enough to be recommended for general use, including by new users. We're therefore making that version, "Production Release 4.14" available for download today.


JMRI is now only available under the GNU General Public License. For more information, please see our copyright and licensing page.

Update From Older JMRI Versions

If you are currently using JMRI 4.9.6 or earlier, we strongly recommend that you update to JMRI 4.12 and make sure that's running OK before updating to this release release. There have been a number of changes in serial port support, panel file format and configuration options since those earlier releases, and moving to the stable JMRI 4.12 release is a good way to work through any possible problems.

If you are currently using JMRI 4.7.3 or earlier on Linux or macOS (Windows doesn't need this), you must update to JMRI 4.12 and carrying out the migration process described in the JMRI 4.12 release note before updating to this release.

Known problems with this release

New warnings for this production release:

Older warnings

See the JMRI 4.12 release note for more warnings predating the 4.13 development series. These may be relevant to you if you're updating from an earlier version.

When running JMRI using Java 9 or Java 10, the script import statements need to be fully-qualified: in addition to 'import java', you might need 'import java.beans' and others.

Since JMRI 4.11.8 Some new display capabilities were introduced into Layout Editor during JMRI 4.11-series development. This release changes some of the defaults in this area, which might change the appearance of some track segments on your panels if they're still using default values. If you select them and change their properties, then save your panel file(s), you can restore their previous appearance. There's a PDF document with more details. We apologize for the inconvenience.

Since JMRI 4.11.8 Because of changes to the "node identification" algorithm used to tell one computer running JMRI from another, you might receive a warning message about the "Node Identity" the first time you run JMRI version 4.11.8 or newer. (If you have more than one profile, this can happen with each). There's no permanent problem here, but you might have to reset your window preferences (i.e. position and size, column layout, etc) in this case. We apologize for the inconvenience.

Since JMRI 4.11.4 If you are running a local web site with a copy of the JMRI content, as described here, please repeat the "" step near the bottom of those instructions after installing JMRI 4.11.4 (or later). This will make some new formatting available on your local site.

Since JMRI 4.11.4 There are issues with the Pi-SPROG One command station operation. A number of workarounds should be applied:

Pi-SPROG One with version 2.4 or earlier firmware will cause a timeout after a track short circuit. A dialog box will open to inform the user of this. The track power will be turned off and must be turned on again using the power control.

Since JMRI 4.11.2 The system connection preferences (i.e. hardware preferences) are now enforcing the correct form for system prefixes: One upper case letter, optionally followed by a number (one or more digits, e.g. "L12"). Existing prefixes in existing configurations are unchanged, but new ones will have to have the correct form.

Download links:

Please note that the download links in this and future JMRI releases link to Github servers. People are welcome to distribute the download files further via other websites, etc. If you want to check that you've received original, unmodified versions, please check the files against the checksums shown below.

Changes since production release 4.12:

The full lists of changes in each of the preceding test releases (4.13.1, 4.13.2, 4.13.3, 4.13.4, 4.13.5, 4.13.6, 4.13.7) are available in our GitHub code repository.

Hardware Support








Roco z21/Z21

New / Updated decoder definitions


Mistral Train Models




Team Digital




  • The decoder definition file structure was updated with a new "defaultItem" element.


  • Minor changes to use the new standard scale process.


  • The Catalan translation was improved.
  • The Danish translation was improved.
  • The Dutch translation was improved.
  • The German translation was improved.
  • Petr Sidlo improved the Czech translation

Layout Editor


  • Fixed a crash in Logix Tools Find Cross Reference


  • Multiple enchancements to operations, including improved build report message when tracks full in staging

Panel Editors

  • Rotating animated GIFs should now work


  • The process for defining defaults was changed to reduce the change that internal programmers would be inadvertantly selected.


  • Several new sets of signal icons

Turnouts, Lights, Sensors and other elements

  • Fixes and updates to Sensor debouncing
  • Improvements to the Light Add/Edit dialog
  • Fixed a problem setting the sensor debounce timings.


  • Better error messages if you try to run a script without an understandable file extension
  • When running JMRI using Java 9 or Java 10, the script import statements need to be fully-qualified: in addition to 'import java', you might need 'import java.beans' and others. These have been added to the sample scripts. (Although we might have missed a few...)
  • JerryG improved some sample script documentation


Signal Systems

  • The aspect definitions in the AAR signal system were improved.
  • Problems in the BR2003 signal definition were fixed

Signal Masts

  • There is now a native OpenLCB signal mast type
  • Egbert Broerse improved the setup page for the matrix signal mast.
  • The SignalMast definition and editing code has been refactored to make it much easier to add new types

Signal Groups

  • Fixes a bug which caused the system names of Signal Groups to be overwritten.

Simple Signal Logic

  • Improved tooltips

Switchboard Editor

  • A new "Auto Range" option allows you to release the fixed range of items and fill in any start and end address between 1 and 10,000. When a range over 250 is entered, a confirmation dialog pops up.
    The actual range limit is 400 items, unless the Hide unconnected items" box is checked.
  • The spinner to set the number of items was renamed Number of Rows.


since 4.13.4


  • Karl Johan Lisby updated SCWarrants so they don't automatically turn off functions at end of run. This lets you keep them on if e.g. you're starting another warrant.

Web Access

  • New Preference to allow wifi throttles to create turnouts
  • Add new Tables menu and pages to JMRI web server
  • Most JSON WebSocket lists now send individual and list changes

WiThrottle Server

  • New Preference to allow wifi throttles to create turnouts
  • Return client message for invalid loco address, turnout and route requests

Virtual Sound Decoder


New Layout Scale process