Menu bar
Menu button
This opens the main menu of Helgobox/ReaLearn. The same menu opens when you right-click an empty area.
It provides the following entries.
- Copy listed mappings
-
Copies all mappings that are visible in the current mapping list (respecting group, search field and filters) to the clipboard. You can insert them by opening the right-click menu of a row panel.
- Paste mappings (replace all in group)
-
Replaces all mappings in the current group with the mappings in the clipboard.
- Modify multiple mappings
-
- Auto-name listed mappings
-
Clears the names of all listed mappings. As a result, ReaLearn will display dynamically auto-generated mapping names instead.
- Name listed mappings after source
-
Sets the names of each listed mapping to the first line of its source label.
- Make sources of all main mappings virtual
-
Attempts to make the sources in the main compartment virtual by matching them with the sources in the controller compartment. This is useful if you already learned a bunch of MIDI/OSC/keyboard sources in the main compartment, just to find out later that you would like to use a controller preset that exposes virtual sources.
- Make targets of listed mappings sticky
-
Changes the targets of all currently listed mappings so that they use sticky object selectors by attempting to resolve the objects from non-sticky selectors. See Sticky selectors.
- Make targets of listed mappings non-sticky
-
Changes the targets of all currently listed mappings so that they use the desired non-sticky object selectors. You can see this in action in tutorial video 9.
The general procedure is:
-
Choose the desired track selector
-
Choose the desired FX selector
-
ReaLearn will change the selectors for all targets where this is applicable
-
- Move listed mappings to group
-
Moves all currently listed mappings to the specified group. Useful in combination with text search.
- Advanced
-
Provides access to expert features.
- Copy listed mappings as Lua
-
Like Copy listed mappings but generates Lua/Luau code instead.
- Copy listed mappings as Lua (include default values)
-
Generates Lua/Luau code that contains even those properties that correspond to ReaLearn’s defaults.
- Paste from Lua (replace all in group)
-
Like Paste mappings (replace all in group) but treats the clipboard content as Luau code.
- Dry-run Lua script from clipboard
-
Executes the Luau code in the clipboard and opens the returned data structure in a text editor. See Import from clipboard button to learn in which situations this can be useful.
- Freeze Playtime matrix
-
Don’t use this, this feature is not ready yet!
- Compartment parameters
-
This shows all parameters of the current compartment and makes it possible to customize them. See Compartment parameter to learn what such parameters are good for.
Each parameter provides the following customization options:
- Name
-
Changes the name of this parameter.
- Value count
-
Lets you enter the maximum number of values. This automatically turn this parameter into a discrete parameter. See Continuous vs. discrete compartment parameters.
- Compartment presets
-
- Create compartment preset workspace
-
Exports the Luau SDK files of this ReaLearn version into a new compartment preset workspace directory with a random name. See section Writing presets with Luau for details.
- Create compartment preset workspace (including factory presets)
-
Exports the Luau SDK files of this ReaLearn version and all factory presets for this compartment into a new compartment preset workspace directory with a random name. See section Writing presets with Luau for details.
- Open compartment preset folder
-
Opens the ReaLearn preset folder for this compartment in a file manager.
- Reload all compartment presets from disk
-
If you made direct changes to preset files, you should press this to reflect these changes in the compartment preset lists of all open ReaLearn instances (reloads all preset files in this compartment).
This will not apply an adjusted preset to the current compartment, it will just reload the list. If you want to apply a preset that has been changed on disk, you need to reload it by selecting it in the preset dropdown once again!
- Edit compartment-wide Lua code
-
Allows you to edit the compartment-wide Lua code. See section Compartment-wide Lua code.
- Unit options
-
- Auto-correct settings
-
By default, whenever you change something in ReaLearn, it tries to figure out if your combination of settings makes sense. If not, it makes an adjustment. This autocorrection is usually helpful. You can disable this checkbox if you don’t like this behavior.
- Send feedback only if track armed
-
Here you can tell ReaLearn to only send feedback when the track is armed.
At the moment, this can only be unchecked if ReaLearn is on the normal FX chain. If it’s on the input FX chain, unarming forcefully disables feedback because REAPER generally excludes input FX from audio/MIDI processing while a track is unarmed (this is subject to change in the future).
Normally, you don’t have to touch this because Auto-correct settings automatically chooses a reasonable default, depending on which input is selected:
-
If input is set to MIDI: <FX input>, it enables this option so that ReaLearn only sends feedback if the track is armed. Rationale: Unarming will naturally disable control, so disabling feedback is just consequent.
-
If input is set to a specific MIDI or OSC device, it disables this option in order to allow feedback even when unarmed.
-
- Reset feedback when releasing source
-
When using ReaLearn the normal way, it’s usually desired that feedback is reset when the corresponding sources are not in use anymore (e.g. lights are switched off, displays are cleared, motor faders are pulled down).
You can prevent this unit from doing that by disabling this option. This can be useful e.g. when using REAPER/ReaLearn just in feedback direction, in order to take control of a hardware device (= using ReaLearn the other way around, "controlling from target to source").
- Make unit superior
-
Makes this unit superior. See Superior units to learn more about this feature.
- Use unit-wide FX-to-preset links only
-
By default, unit-wide links are applied in addition to the global links and take precedence over the global ones. This checkbox makes sure that only unit-wide links are used.
- Stay active when project in background
-
Determines if and under which conditions this ReaLearn unit should stay active when the containing project tab is not the active one. Applies to in-project ReaLearn instances only, not to monitoring FX instances!
- Never
-
Will only be active when its project tab is active.
- Only if background project is running
-
Follows REAPER’s project tab settings ("Run background projects" and "Run stopped background projects").
- Always (more or less)
-
Attempts to stay active no matter what. Please note that this is technically not always possible when input is set to MIDI: <FX input> or output to MIDI: <FX output>, when the background project is not running.
- Unit-wide FX-to-preset links
-
Manage a unit-wide list of links from FX (plug-ins or JS effects) to ReaLearn main compartment presets. Covered in video tutorial 10.
- Add link from last focused FX to preset
-
This lets you link whatever FX window was focused before focusing ReaLearn, to an arbitrary main compartment preset. This only works if an FX has been focused before.
- Arbitrary FX ID
-
If you have added a link already, you will see it here in the list. What you see, is the so-called FX ID, which by default simply corresponds to the plug-in’s original name (e.g. Name: VSTi: ReaSynth (Cockos) | File: - | Preset: -).
- <Edit FX ID…>
-
With this, you can edit the FX ID manually. See FX ID dialog for details.
- <Remove link>
-
(Globally) removes this FX-to-preset link.
- Arbitrary main preset
-
The rest of the submenu tells you to which main preset the FX ID is linked. You can change the linked preset by clicking another one.
- Logging
-
- Log debug info (now)
-
Logs some information about ReaLearn’s internal state. Can be interesting for investigating bugs or understanding how this plug-in works.
- Log real control messages
-
When enabled, all incoming MIDI messages, OSC messages or key pressed will be logged to the console. See Logging of real control messages.
- Log virtual control messages
-
When enabled, all triggered virtual control elements and their values will be logged (see Controller compartment).
- Log target control
-
When enabled, all target invocations (parameter changes etc.) will be logged.
- Log virtual feedback messages
-
When enabled, all feedback events to virtual control elements will be logged (see Controller compartment).
- Log real feedback messages
-
When enabled, all outgoing MIDI or OSC messages will be logged to the console. See Logging of real feedback messages.
- Send feedback now
-
Usually ReaLearn sends feedback whenever something changed to keep the LEDs or motorized faders of your controller in sync with REAPER at all times. There might be situations where it doesn’t work though. In this case you can send feedback manually using this button.
- Instance options
-
- Enable global control
-
If you enable this option, this Helgobox instance will start to automatically add/remove units based on connected controllers. See Auto units.
- Open Pot Browser
-
This will open Pot Browser. See Pot Browser for details.
- Show App
-
Shows the Helgobox App associated with this Helgobox instance.
- Close App
-
Closes the Helgobox App associated with this Helgobox instance.
- User interface
-
- Background colors
-
Enables/disables the usage of background colors in the ReaLearn user interface (enabled by default).
- Server
-
ReaLearn features a built-in server which allows the Companion App (and in future also the Helgobox App) to connect to ReaLearn. The server runs globally, not per instance!
- Enable and start!
-
This starts the server and makes sure it will automatically be started next time you use ReaLearn.
- Disable and stop!
-
This stops the server and makes sure it will not be started next time you use ReaLearn.
- Add firewall rule
-
Attempts to add a firewall rule for making the server accessible from other devices or displays instructions how to do it.
- Global FX-to-preset links
-
Allows you to manage global FX-to-preset links. Works exactly as the Unit-wide FX-to-preset links menu.
FX ID dialog
The FX ID dialog is used to edit which properties of a FX trigger a preset change. It is opened via menu action <Edit FX ID…>.
- FX name
-
Allows you to adjust the (original) plug-in name that triggers the preset change.
- FX file name
-
Allows you to adjust the plug-in file name that triggers the preset change.
- FX preset name
-
Maybe the FX name or file name is not enough for you to decide which preset you want to load. You can add a preset name as additional criteria.
Example 1. SamplersIf you have a sampler, you can load different ReaLearn presets depending on which sample library is loaded into your sampler. Just add two links with the same FX file name (e.g.
Kontakt 5.dll) but different preset names.
All above-mentioned fields support wildcards.
You can use * for matching zero or arbitrary many characters and ? for matching exactly one arbitrary character.
Instead of relying on the original plug-in name you could match plug-ins with similar file names (e.g. VST2 and VST3 at once): Pianoteq 7 STAGE.* would match both Pianoteq 7 STAGE.dll (VST2) and Pianoteq 7 STAGE.vst3 (VST3).
Export to clipboard button
Pressing the export button allows you to copy ReaLearn’s settings to the clipboard so you can import them in another instance/unit or edit them in a text editor. See Import/export.
- Export instance as JSON
-
Copies a complete dump of this Instance to the clipboard in JSON format.
- Export main/controller compartment as JSON
-
Copies a dump of the currently visible compartment to the clipboard. It contains about the same data that a compartment preset would contain.
- Export main/controller compartment as Lua
-
Copies a dump of the currently visible compartment to the clipboard as Lua/Luau code (ReaLearn Script). This form of Lua/Luau export skips properties that correspond to ReaLearn’s default values, resulting in a minimal result. Perfect for pasting into a forum or programming ReaLearn with focus on only those properties that matter to you.
- Export main/controller compartment as Lua (include default values)
-
This Lua/Luau export includes even those properties that correspond to ReaLearn’s default values, resulting in more text. This gives you the perfect starting point if you want to extensively modify the current compartment (using the Luau programming language) or build a compartment from scratch, using even properties that you haven’t touched yet in the user interface!
Import from clipboard button
Pressing the import button does the opposite: It restores whatever ReaLearn dump is currently in the clipboard. It supports JSON or Luau. See Import/export.
Projection button
Click this button to enter ReaLearn’s Projection feature. You can choose between the old browser-based projection (which is going to disappear soon) and the new projection that is part of the Helgobox App (but not yet fully functional). Hopefully, the transition to the Helgobox App, including mobile versions of that App, will soon be finished.