JetStream Finale Controller Installation for Keyboard Maestro

Note: current files can always be found at jetstreamfinale.com

Keyboard Maestro

JetStream KM is designed to access the most powerful features of JetStream Finale Controller. While it can be used in conjunction with the Stream Deck hardware, it can also operate completely independently of it, or be integrated into your JetStream Finale Controller Stream Deck setup for increased productivity.

Some of the more basic functionality of the JetStream Finale Controller, such as menu or tool selection, have been left out of this version. The logic is that as a KM user, you most likely have already programmed your own shortcuts for tool and menu selection. Even so, there are over 400 powerful functions in this version.

The KM version allows you to access the more advanced functionality of the JetStream.lua scripting, divided into 21 Groups.

By default, each of the 21 groups is set up as a Keyboard Maestro Palette, which are activated and deactivated by a shortcut. Of course, you can change the shortcuts to whatever you want, and create your own custom palettes to group things in the best way for your own workflow.

Since most Keyboard Maestro users have a fairly extensive set of shortcuts already, we tried to use shortcuts for default key bindings that you might not already have in use. All use three modifiers together; CONTROL ⌃, OPTION ⌥, and COMMAND ⌘.

Dynamics ⌃⌥⌘0, Articulations ⌃⌥⌘F1, Noteheads ⌃⌥⌘F2, Lyrics ⌃⌥⌘F3, Barlines & Form ⌃⌥⌘F4, Meter & Rhythm ⌃⌥⌘F5, Smart Shapes ⌃⌥⌘F6, Staff Styles ⌃⌥⌘F7, Expressions ⌃⌥⌘F8, Percussion Beaters ⌃⌥⌘B, Tuplets ⌃⌥⌘F9, Staff Groups ⌃⌥⌘F10, Key & Tonality ⌃⌥⌘F11, Page & Layout ⌃⌥⌘F12, Layers ⌃⌥⌘F13, Polyphony ⌃⌥⌘F14, Transformations ⌃⌥⌘F15, Chord Symbols ⌃⌥⌘F16, Reset ⌃⌥⌘F17, Playback & Navigation ⌃⌥⌘F18, and Plugins ⌃⌥⌘F19.

Once the KM Palette is visible on screen, you can click on the function you want, or, in the case of some of the palettes, you can type a key shortcut or text string to trigger the function. Since Palettes only respond to specific strings or shortcuts when open, you can reallocate shortcuts as you need to.

In the “Plugins” group, you will find a Check for “JetStream KM Updates” – you can check for newer versions at any time. Note that if you change any shortcuts, you should move these functions into your own groups, as the updater loads the full set each time.

Download & Install KM Macros

You should have received a link via eMail. Download, and unzip the Keyboard Maestro version file. Double click on the file labeled JetStream Macros.kmmacros to add JetStream to your Keyboard Maestro setup.

Install JW Lua

  1. Find your Finale plug-ins folder (If you’re not sure where it is, you can always check in the Folders section of your Finale Preferences). The default locations for various versions are:

Finale v26: /Library/Application Support/MakeMusic/Finale 26/Plug-ins

Finale v25: /Library/Application Support/MakeMusic/Finale/Plug-ins

Finale 2014.5: /Library/Application Support/MakeMusic/Finale 2014.5/Plug-ins

  1. Navigate to that folder in the Finder and create a new folder called “JW Lua” (note the space) and open it.
  2. Use the following links to download JW Lua:
    1. Finale 25 and later (Most Compatible)
    2. Finale 2014.5 and earlier (May Lose Some Functionality)
  3. Locate the downloaded zip file and double-click it to create a .bundle file. For Finale 25 and later this will be jwlua64.bundle. For earlier versions it will be jwlua.bundle.
  4. Add the .bundle file to the JW Lua folder created in step 2.

Download the JetStream files

By signing up with us you should have received an email with a link to a .ZIP file containing:

  1. The main JetStream Finale Controller profile (or JetStream Finale Controller proXL).
  2. The JetStream Current profile (or JetStream Current pro XL) for your own customizations.
  3. The JetStream.exe macro program.
  4. The current JetStream.lua script.

Install the JetStream.lua script

  1. Copy the JetStream.lua file you downloaded to a location you can remember.
    1. You may want to use the Library/Application Support/MakeMusic/Finale…./Plug-ins/JW Lua folder you created above.
    2. Another option might be a cloud synced folder that you access from multiple computers.
  2. Launch Finale, and open a document (the Plug-in menu is not available without an open document).
  3. Choose Plug-ins > JW Lua > JW Lua…. The JW Lua plug-in appears.
  4. Select the Manager tab.
  5. Under Plug-in Groups, select Menu.
  6. In the Items in Group section, click New. An Open dialog box appears.
  7. Navigate to where you copied JetStream.lua and choose JetStream.lua. Click Open, and the JetStream lua script should appear in the list at the bottom of the plug-in.
  1. You may get a warning that changes will not be reflected until you restart Finale. Close this dialog box, close the plug-in, and exit Finale so that the menu updates.
  2. Launch Finale again, and open a document so the plug-ins aren’t grayed out. “JetStream Finale Controller” should appear under Plug-ins > JW Lua

Please Read Our Disclaimer:

Ongoing development of JetStream Finale Controller, and the JetStream software product itself is completely and totally separate from Finale, MakeMusic, Stream Deck, Elgato Gaming, Keyboard Maestro, Stairways Software or their affiliates. No financial, tech support or other arrangements have been made with these companies.

Use the JetStream at your own risk. We’re not responsible for any adverse consequences. It’s freeware, after all! ¯\_(ツ)_/¯