The StreamDeck Cubase plugin by default locates the highest installed Cubase version and uses key and midi definitions from that version. It also assumes that the first defined Generic Remote device is to be used for midi definitions. If these two criteria match your installation, you don't need to do anything.
If, however, you have multiple Generic Remote devices or want to "talk to" a lower Cubase version, you can change the behavior through the file "StreamDeckCubaseUserSettings.xml". As installed during the plugin installation, this file looks like this:
<?xml version="1.0" encoding="utf-8" ?> <Settings> <CubasePath></CubasePath> <GenericRemoteName></GenericRemoteName> </Settings>
If you want to use this file, you must first make a copy of the file to your Documents folder (from "%appdata%\Elgato\StreamDeck\Plugins\se.trevligaspel.cubase.sdPlugin), then make the appropriate changes in that copy. The file installed in the plugin folder is a template only and is never accessed by the plugin in that location.
Changes to this file are immediately read by the plugin. Previous versions of the plugin required a restart of the Stream Deck process but this is no longer necessary.
- Alternate Cubase version
The CubasePath parameter defines the path to the Cubase folder to use. If the parameter is empty, the default behavior (locate the highest installed version) is used. If the parameter contains a path, that path is used. The recommended configuration is to use the %appdata% environment variable and then add the rest of the path to the Cubase folder that contains "Defaults.xml" and "Key Commands.xml":
- Alternate Generic Remote device
The GenericRemoteName parameter defines the name of the Generic Remote device present in the Cubase Studio Setup Remote Devices list. If this parameter is empty, the first defined Generic Remote device is used. If you want the plugin to work with another instance of Generic Remote device, you need to define the name here:
Please note that the English name "Generic Remote" should be used regardless of how it is presented in the Cubase Studio Setup window. If you have a non-English version of Cubase you will have a localized name in the Studio window but must still use the English name in this file.
<GenericRemoteName>Generic Remote 2</GenericRemoteName>
- Multiple Generic Remote devices
You can add multiple rows of GenericRemoteName declarations if you want to use multiple Generic Remote devices in Cubase.
<GenericRemoteName>Generic Remote</GenericRemoteName> <GenericRemoteName DisplayName="Mixer">Generic Remote 2</GenericRemoteName>
If two or more GenericRemoteName declarations are present, the action will display a dropdown where you can decide which remote device to access for that action. The commands available in the Commands dropdown will update to display the commands available in the selected Generic Remote device in Cubase.
It is possible to add a "DisplayName" attribute (see the example above) that will be displayed in the dropdown for the action. If no "DisplayName" attribute is present, the name of the Generic Remote device is displayed.Please note that you must yourself make certain that definitions in different Generic Remote devices doesn't overlap and specify the same channel/address. When you use (i.e. send) a command selected from a specific Generic Remote device you don't really reference the Generic Remote device in any way. The only thing that is sent is a Control Change command with the parameters that were defined in the Generic Remote setup. If you have multiple Remote Devices that have actions that respond to the same channel/address, all of those actions will be triggered which can create a difficult-to-diagnose result.