ReaSonus Control Panel

The ReaSonus Native Control Panel is the place to be for configuring your FaderPort. The Control Panel has several tabs:

  • Function Keys: Assign actions to the function keys
  • Custom Filters: Create custom filters to make mixing easier (FaderPort 8/16 only)
  • Plugin Mapping: Edit your plugin mappings here (FaderPort 8/16 only)
  • Settings: Control all the settings
  • About ReaSonus: What's in the name

In the next chapters you can read more about all the functionalities.

The image is for the FaderPort 8/16.

Functions Management

Within ReaSonus Native it is fairly simple to manage the actions attached to the function buttons. To open the window click the [Left Shift] + [Macro]-button, or open the ReaSonus Native Control Panel and select the Function Keys tab.

There are 2 tabs with 8 fields (4 for the FaderPort V2) for the function keys.

Each block shows the name and info for the corresponding action. Selecting an other action can be done by clicking the icon in the top right corner. This will open the acions list.

Click the save button to save your changes.

Plugin Mapping

There are multiple ways of managing the mapping of plugin parameters. By far the easiest will be via MIDI Learn. You can also use the UI, which gives you the option to change parameter names, step number, and so on. This requires changing the mapping files by hand.

This is a FaderPort 8/16 only functionality

New Plugin Mapping

The idea about the MIDI Learn method is to make the mapping as simple as possible. When in the Plugin Channel Mode:

  • Press the Solo button to open the window of that plugin.
  • Press the Link-button will open the editing mode. If no mapping has been done for the selected plugin, a new mapping will be created automaticaly. In this mode the button is blinking.

Now a configuration file gets created in the background and the linking is started. All displays should have 2 lines with the text Free in it.

Now you can wiggle/touch a parameter in the plugin and then press the Select button of the channel you want to assign it to or touch the fader. This should change the text Free to the name of the parameter (The top one for the select button and the bottom one for the fader).

The Select-button can be used fo toggle buttons (on/off) or plugin parameters with a limited amount of steps. in that case, when the correct data is available from the plugin, pressing the Select-button will loop through the options

If all channels are populated (or earlier) you can use the Pan/Param encoder to scroll to a next set of empty slots

If you want to disconnect an assignment, you can press the Right Shift and press the Select button or touch the fader you want to disconnect. The connection in removed and the text will change to Free again.

Once done editing, press thge Link-button again. Now you can use your mapping instantly

Edit Mapping

If the selected plugin already has a mapping, this will get activated instantly. If you want to make changes to the mapping, press the Link button. This will enable the edit mode. All values should be cleared from the displays and the empty slots will display the Empty text again.

If you want to overwrite a mapping, just wiggle/touch a plugin parameter and the select the control you want to assign it to. This will overwrite it

Overwriting names

It is also possible to overwrite parameter names. Check the Ui tab for this.

Within ReaSonus it is also possible to manually add a mapping or to edit some settings of the mapping. If you want to use this, do one of teh following:

  • Go into the learn mode. In this mode, press the Left Shift and press the Select button of the channel you want to edit. This opens the Plugin Mapping with the current effect and parameter selected.
  • Open the ReaSonus Control Panel and open the tab Plugin Mapping. Then you can select the developer and the plugin.

The panel

On the left side you see the list of plugins which are already mapped. The are gouped by developer to make searchin a bit easier.

On the right side at the top you see a list with numbered buttons. These represent the tracks you assign the controls to. When the list gets larger you can scroll through the list. Clicking a button it will show the the settings for that track.

The Fields

  • Control Name: The display name for the control. This is how the parameter appears in the display and is editable
  • Original Name: The name given by the developer of the plugin. This is not editable and purly for reference
  • Param Id: The index of the parameter.
  • Number of Steps: (Select only) the numbe rof steps/options for the parameter. In case of on/off this will be 2

Click the save button to save your changes.

The mapping of the plugins is done in simple ini files. These can be opened in your editor of choice. The files are located in the next location: /ReaSonus/Plugins. All the plugins are grouped by developer what makes searching a bit easier

More info will follow

Filters Management

ReaSonus Native has the ability to create and manage your own track filters. The filters are based on file names with additional options. To open the window click the Macro-button. Or select the Custom Filters tab in the ReaSonus Control Panel.

Don't forget to click the save button when you're done editing.

Adding and removing filters

The left side of the window contains the list with available filters. If you want to delete a filter, select the filter in the list and click the 'X' button on the right

Adding a new filter is as simple as deleting one. Enter a name in the input field above the list and click the '+' button.

The order of the filters on the FaderPort is the same order as they appear in the list. You can change the order by dragging and dropping the items.

The Filter Options

The first match the filter makes is by name. If no name is provided, no tracks will be visible by selecting that filter. After the name the filter is checking by the given options.

  • Filter name: The name of the filter. This will be the name used in the list on the left side and in the displays of the controller.
  • Filter text: Adding a text can be done by entering it in the input field and click the 'plus' button. Removing an item can be done by selecting it and clicking the 'X' button on the right.
  • Show track siblings: Show all the sibbling tracks of matching tracks
  • Show track parents: Show all parent tracks of matching tracks
  • Show track children: Show all the child tracks of matching tracks
  • Show only top level tracks: Shows only the filtered tracks if they are top-level
  • Match multiple: By default the names wil only match the first item. Enabling this option will show all matches

The 'Preview'

There is a 'Preview' available that represents your settings. The 2 channels with the dark-yellow background represent tracks that match the name. The ones with the bright yellow border will be the ones that will be visible after using the filter.

This 'Preview' should help you a bit with understanding the effect of the different filter options and how they interact with eachother

Using your own filters

To use your own filters press [Left Shift] + All. This will show all your self created filters in the displays. If you have created more then 8/16 filters, use the pan encoder to scroll to the next filters.

If there is a filter available press the Select-button to select the filter. The All-button will now be yellow.

If no filter is available, the display tells you so. Pressing the select button then will ask you if you want to open the Filter Management window.

Translations Editor

Within Reasonus Native it is possible to manage languages and translations.

Add Language

  • Open the Reasonus Native Translations Editor via:
    • Actions List: Search for translations and select the proper action
    • Open the Settings Page in the ReaSonus Native Control panel
  • Enter a name for the new language. It is recommanded to follow the next convention:
    • The first 2 letters are for the language like en, nl, fr, in lower case
    • The second 2 letters will be the country like CA, DE, etc
    • Connevct these with a dash like: en-US, fr-CA
  • Click the add icon next to the input field. A new file for your language is created and populated with the en-US translations
  • Now you can edit the translations to your liking and sasve the changes
  • After editing the changes you can go to the Settings Page in the Control Panel
  • Select your language and click Save

Contribute

For now, only en-US will be shipped with ReaSonus Native. If you think your language should get added to the ReaSonus Native install, please contact me. When doing that, please keep in mind that I will ask you for updates to the file when changes are needed, so it not a one-of.

How do updates work

A little bit of technical background:

  • When updated with ReaPack the new en-US translation file will get installed in the /UserPlugins/ReaSonus folder
  • On startup of REAPER the current en-US file will get overwritten with the new one.
  • All other language files will get updated with the newly added translations. (current translations will off course stay as they are)
  • You can now update the newly added translations to the language you want

ReaSonus Actions

With ReaSonus Native also some actions get installed. These are internally also used in the extension, but if you want one or more of them as a menu button, you can.

Reasonus: Toggle follow the play cursor

Toggle Follow the play cursor. This action has a state, so should reflect its state in the button

ID: REASONUS_TOGGLE_PLAY_CURSOR_COMMAND

Reasonus: Show the ReaSonus Native 8/16 Control Panel

Toggle the ReaSonus Control Panel for the FaderPort 8/16. This action has a state, so should reflect its state in the button

ID: REASONUS_SHOW_REASONUS_8_CONTROL_WINDOW

Reasonus: Show the ReaSonus Native V2 Control Panel

Toggle the ReaSonus Control Panel for the FaderPort v2. This action has a state, so should reflect its state in the button

ID: REASONUS_SHOW_REASONUS_V2_CONTROL_WINDOW

Reasonus: Show Reaper resource path

Shows the Reaper Resource folder location in a console so you can easily copy it

ID: REASONUS_SHOW_REAPER_RESOURCE_PATH_COMMAND

Reasonus: Close all floating fx windows

Closes all the open fx windows. All other windows just stay open

ID: REASONUS_CLOSE_ALL_FLOATING_FX_WINDOWS_COMMAND

Reasonus: Convert the old zon mappings to the new ini mappings

Convert all the zon plugin mapping files from the old ReaSonus version to the new file structure

ID: REASONUS_CONVERT_PLUGIN_ZON_TO_INI

Remove old version

If you had the 'old' ReaSonus version installed, installing the new one will leave you with some artifacts. Within the Actions List there is a huge list of old ReaSonus actions that addde some of the logic. You do not need them anymore.

Step 1

First we will remove all the actions from the list. This can be done by going to the Reaper resource folder. Once in the folder:

  • Search for reaper-kb.ini and make a copy of it (just to be sure)
  • Open the file in your editor of choice
  • There will be a list of lines like SCR 4 0 REASONUS_ALWAYS_ON "Reasonus: Always On" Reasonus/always-on.lua
  • All the lines with REASONUS_ in it can be removed. Please take care not to remove other lines
  • Save your changes and step 1 is done

Step 2

Now we will remove all the actual files with th scripts

  • In the Reaper resource folder is a folder named Scripts. Open this folder
  • Inside this folder you'll see all scripts added by either yourself or other script makers
  • Therer should be a folder named: Reasonus, and remove it
  • We're done

When you now restart Reaper and go to the actions list all the old ReaSonus scripts should be gone.