JetStream Finale Controller Installation for Windows

NOTE: Here’s a brief overview of how JetStream works. You push a button on your Stream Deck. That sends a command to JetStream.exe, which in turn executes another function. Sometimes that means it will access a menu item, sometimes that means it accesses the JetStream.lua script and enters a 4-digit code.

JetStream.exe is not meant to be run on its own, and you will only get an error message from it if you try. Likewise, if you try and access the “Jetstream Finale Controller” script directly it will ask for a code… But with over 400 functions built in you won’t know what code is for what function!

JetStream currently only works with the English version of Finale.

Please follow these directions carefully.

Install Stream Deck Software

  1. Install the Stream Deck desktop application from Downloads |
  2. There are different options for Stream Decks that work with the current setup:

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”.
  3. Scan the QR code presented on your screen with your iPhone/iPad.

Install JetStream files

  1. Find the .ZIP file you downloaded with the JetStream files. Open or extract it, and run the file inside called “JetStream Setup.exe”. If you are asked by Windows, give it permission to make changes.
  1. During the installation, you will be asked where you want to install the JetStream Lua script, and where Finale looks for its plug-ins. The default settings are to create a new folder for the Lua script in your Documents folder, and to use the default settings for plug-ins for Finale 26… But you can change these to whatever values you need. The JetStream installation will remember your choices for any further updates by writing values into your Registry (HKEY_CURRENT_USER\SOFTWARE\JetStream). Whatever you choose, remember the location of the Lua script, because you will need to access this in a later step!
  1. Click through the rest of the installation program. When you are done, a folder will pop open that was created in your Documents folder that contains two StreamDeck profiles. Double click each one, which will load them into the Stream Deck software.

Enable the JetStream.lua script

  1. Launch Finale, and open a document (the Plug-in menu is not available without an open document).
  2. Choose Plug-ins > JW Lua > JW Lua…. The JW Lua plug-in appears.
    • IF YOU DO NOT SEE THE JW LUA PLUG-IN: You probably installed the plug-in to the wrong place. Open up your Finale preferences and find out where it is looking for plug-ins, and make sure that when you run the JetStream installation program it is pointing to the same location!
  3. Select the Manager tab.
  4. Under Plug-in Groups, select Menu.
  5. In the Items in Group section, click New.
  1. Hey, remember when I told you to remember where you installed the JetStream.lua? In the Open dialog box that pops up, navigate to that place on your computer and select the JetStream.lua file.
  1. You will 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. Hurray!

Check your Antivirus Settings

JetStream installs an .exe on your computer that uses the AutoIt scripting language to interface with Finale’s menus. AutoIt programs can sometimes trigger false positives from antivirus software as a trojan virus. Please be assured that our program does nothing harmful to your computer, but the antivirus software doesn’t know that. You will need to have your antivirus software ignore either the JetStream.exe file itself, or to ignore the entire folder you will install it to (C:\Program Files\Elgato\StreamDeck\JetStream).

If Windows Defender doesn’t like the .exe file, it simply deletes it. Then when you push a button on the StreamDeck, you get a little exclamation point icon (!), and nothing happens… Super annoying!

If you run into this problem, here are instructions for allowing exceptions in Microsoft’s Windows Defender:

  1. Open the Windows Security app by pressing the Windows Key and typing “Security,” then hitting Return.
  2. In Windows Security, click on Virus & threat protection.
  1. Under Virus & threat protection settings click Manage settings.
  1. Scroll down until you find Exclusions, then click Add or remove exclusions.
  1. Click on the + next to Add an exclusion and choose Folder from the dropdown list. Navigate to C:\Program Files\Elgato\StreamDeck\JetStream and choose Select Folder.
  1. If Windows Defender did delete your .exe file, you may need to run the setup program again.
  2. Note that if you use 3rd party antivirus software such as AVG or McAfee, you may need to follow other directions specific to your product.

Configure the JetStream Stream Deck Profiles

You should already have installed the two StreamDeck profiles in an earlier step. To get the full functionality of JetStream and JetStream Current, make sure they are linked to one another. “Custom Control” is a special type of button in the Stream Deck which connects two related profiles together.

  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. Set the destination Profile to “JetStream Current.” (Note that you will have to do this each time you update to a new version of JetStream Finale Controller as well).

3. Now you need to open the “JetStream Current” profile. This “custom” or “current” profile also needs to link *back* to the main JetStream Finale Controller profile.

Locate the “JetStream Control” button at the top left, and in the Profile: popup, choose “JetStream Finale Controller”. You will now be able to navigate between your Custom (Current) profile and the main JetStream Finale Controller profile for maximum productivity.

If you are just starting out we recommend that you first familiarize yourself with the various groups of tools and functions built into the main JetStream before experimenting with creating your own task groups.

Once you are ready to start creating your own custom control layouts, simply copy any button from the main JetStream Finale Controller to your computer clipboard (don’t CUT!), then switch to the JetStream Current profile and paste into your desired location.

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! ¯\_(ツ)_/¯