Some FinaleLua scripts require modifier keys (shift/option) to be held when selecting their menu item to access optional behaviour like skipping a confirmation dialog. This is really hard with KM on Mac because Finale can only detect a modifier key when a MOUSE event occurs with modifiers at the exact moment the menu item is selected.

Previously I'd achieved this by getting KM to simulate a virtual mouse click from a screen-captured "Found Image" to find where to click the mouse. That was messy and failed for different users or whenever a system update changed menu item display.

This new version is slicker, more robust and doesn't need captured images or the installation of a linked Lua utility script. It should work (hopefully) on most systems with little modification. It requires four things:

1. Use RGPLua. JWLua support stopped in 2017 and it doesn't work with many recent RGPLua scripts. (Get installation instructions from FinaleLua.com).
    
2. Any scripts you want to use with modifier keys should be set up the same way with RGPLua, so they appear in the RGPLua menu. That menu can be called anything you like, just enter the given name in the first stage of the KM Macro below.
    
3. In the second stage of the macro enter the name of the Lua script you want to activate, spelt the same way it is in your RGPLua menu. Be careful in KM Editor because it will replace three dots "..." with a single ellipsis character (…) if Edit → Substitutions → Smart Dashes is enabled.
    
4. Download the KM macro KM_Finale_Menu_Shift-Clicker_V2 and open it with KM so it will work within Finale. (After downloading the file make sure the filename ends in ".kmmacros").

Back to: Lua Scripts for Finale.