JetStream Finale Controller Installation for OS X

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

Install Stream Deck Software

  1. Install the Stream Deck desktop application from Downloads | elgato.com.

Note: Make sure you are working on an admin account for versions 4.3 or earlier. The desktop version has a known bug which happens on non-admin accounts which Elgato will fix in version 4.4.

  1. There are Two different options for Stream Decks that work with the current setup:

The Stream Deck XL for Mac is currently in beta and will be supported in future releases.

  1. JetStream makes extensive use of mushoo’s RunAppleScript plug-in to call Finale menu items directly. Download the plug-in here.
  2. Double click on the downloaded file com.mushoo.RunAppleScript.streamDeckPlugin to install it.

Once installed, you may delete the file from your downloads. The RunAppleScript plug-in should now appear as an option in your Stream Deck software, at the bottom of the list of Actions on the right.

If it doesn’t,  click located in the upper right of the Stream Deck app, scroll down and check the “Custom” and “RunAppleScript” options:

Note: You may be prompted to allow the Stream Deck app to use the accessibility features. If so, go to System Preferences > Security and Privacy > Accessibility, and check Stream Deck from the menu. You may need to authenticate the decision with an administrator username and password.

Syncing the iOS app with your Computer

  1. Ensure both your iPhone/iPad and computer are on the same Wi-Fi network.
  2. Click on “Stream Deck” in the upper left hand corner of the app and select “Add iPhone”.
  1. Scan the QR code presented on your screen with your iPhone/iPad.

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 Latest JetStream files

Visit jetstreamfinale.com and download:

  1. The current Mac Stream Deck Profile Set .zip file containing:
    • The main JetStream Finale Controller profile
    • The JetStream Current profile (for your own customizations)
  2. If you did not install mushoo’s RunAppleScript plug-in earlier, do so now.
  3. 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

Install and Configure the JetStream Stream Deck Profiles

You can install Stream Deck profiles by simply double clicking them. To get the full functionality of JetStream and JetStream Current, make sure they are linked to one another.

  1. Using the Stream Deck configuration software, switch to the JetStream Finale Controller profile, and choose the “Custom Control” icon in the upper left.

2. This button will have reverted to “Next Profile.” Set it instead to switch to “JetStream Current.”


3. Now switch to the “JetStream Current” profile and find the “JetStream Control” button, and change it to switch to the main “JetStream Finale Controller” profile.

NOTE THAT THIS STEP WILL NEED TO BE REPEATED WHENEVER YOU UPDATE THE JETSTREAM PROFILE