Skip to content

MouseMaster Configurator v2.2.0

Latest

Choose a tag to compare

@github-actions github-actions released this 06 Aug 12:06
· 1 commit to main since this release

MouseMaster Configurator v2.2.0

Summary

This release updates the fork's Windows configurator for MouseMaster v91.
It keeps the existing binding and motion editors while adding a dedicated
advanced page for v91 configuration features. The configurator remains a
standalone .NET Framework WinForms application and is maintained by this fork;
it is not part of the upstream MouseMaster project.

The release is GUI-only. Install the MouseMaster v91 runtime separately when
using the generated configuration with MouseMaster.

Highlights

  • Synchronizes the fork with the exact upstream MouseMaster v91 tag and updates
    the configurator documentation and terminology from v89 to v91.
  • Adds the v91 Advanced settings page with a mode/property scope selector and
    localized Chinese/English controls.
  • Adds recursive Hint controls for area source and center, width and height
    percentages, fixed or fit cell sizing, row and column limits, label
    overrides, and vertical alignment.
  • Adds typed controls for decoration, subdecoration, and
    subsubdecoration, including grid dimensions, labels, box and border
    styling, closed edges, fonts, outlines, spacing, and shadows.
  • Adds UI Hint scan scope controls for active-window, active-screen, and
    all-screens behavior.
  • Adds selected-cell Zoom controls for area source, area dimensions, center,
    zoom percentage, animation enablement, duration, and easing.
  • Adds the Indicator-as-cursor setting and preserves the existing indicator
    controls.
  • Adds global initial variable declarations and virtual-key declarations.
  • Adds an advanced expression editor for complex v91 properties, including
    set-variable, unset-variable, reset-variables, and other expressions
    that cannot be represented as a simple key chord.
  • Preserves unknown v91 properties, ordinary comments, disabled properties,
    line continuations, and multiline expressions through load/save round trips.
  • Extends validation for v91 enum values, numeric ranges, variable and
    virtual-key names, key alias collisions, malformed variable commands, and
    incompatible UI Hint settings.
  • Updates release automation so configurator releases publish only the GUI,
    its license, and a SHA-256 checksum manifest.

Compatibility and Migration

  • The provided MouseMaster v89 mousemaster.properties was loaded directly by
    the real MouseMaster v91 executable (mousemaster v91 (dd4e689)) without a
    configuration parsing error.
  • Existing v89 configurations do not need to be replaced with a v91 template
    or re-personalized. Existing settings remain usable as-is.
  • v91-only settings are optional. If they are absent from an older file,
    MouseMaster uses its normal defaults; configure them in the Advanced page
    only when those features are wanted.
  • The configurator reads old mmcfg metadata, writes v91-compatible key
    names, and creates a .gui-backup before replacing a configuration file.
  • Unknown properties and ordinary comments remain outside the configurator's
    managed state and are preserved unless the user explicitly changes or
    removes them.

Verification

  • Configurator build: configurator/build.ps1 completed successfully.
  • Configurator self-test: PASS: 331 assertions.
  • Java unit tests: 210 tests, 0 failures, 0 errors.
  • Maven package: completed successfully for MouseMaster v91.
  • Runtime version probe: mousemaster v91 (4d48a56) from the synchronized
    source JAR.
  • Real runtime version probe: mousemaster v91 (dd4e689) from the configured
    test executable.
  • The original v89 properties file loaded successfully in the real v91
    runtime, and a configurator-generated v91 acceptance configuration also
    loaded successfully.
  • The real focus-mode integration test passed with the generated acceptance
    configuration, including pass-through, swallowed input, and restored input
    assertions.
  • git diff --check passed and upstream tag 91 is an ancestor of the
    published source.

Release Assets

  • MouseMasterConfigurator.exe: the Windows GUI configurator, version
    2.2.0.0.
  • configurator-LICENSE.txt: configurator license text.
  • SHA256SUMS.txt: SHA-256 checksums for the two release files.

This release intentionally does not include mousemaster.exe, built-in
MouseMaster configuration files, or a native MouseMaster runtime bundle.

Known Limitations

  • The configurator requires Windows and the .NET Framework 4.x compiler/runtime
    environment described in configurator/README.md.
  • The v91 native MouseMaster executable is not distributed by this release;
    obtain it separately from the corresponding MouseMaster v91 release.
  • Future MouseMaster properties not covered by typed controls are preserved in
    the advanced property surface, but may require raw editing until dedicated
    controls are added.