Skip to content

helgoboss/helgobox

Repository files navigation

Helgobox: ReaLearn & Playtime

Installation

Helgobox is provided as ReaPack package, which is great because it allows you to keep your installation up-to-date very easily.

There are multiple ways to carry out the initial installation.

Install automatically via ReaBoot

The easiest way to install Helgobox is via the following ReaBoot link: Install Helgobox

Install manually via ReaPack

As an alternative, you can install Helgobox via ReaPack directly:

  1. Install ReaPack if not done so already

  2. Extensions → ReaPack → Import repositories…

  3. Copy and paste the following repository URL:

    https://github.com/helgoboss/reaper-packages/raw/master/index.xml
  4. Extensions → ReaPack → Browse packages…

  5. Search for helgobox

  6. Right mouse click on the Helgobox package → Install…

  7. OK or Apply

  8. Restart REAPER

Install manually without ReaPack

If you are more the download type of person, you can find the latest dll, dylib and so files here at GitHub on the releases page for manual installation.

You also must install Helgobox manually if you plan to use it in both REAPER for Windows 32-bit and REAPER for Windows 64-bit because then it’s important to use two separate VST plug-in directories.

Please note that it’s impossible to run Helgobox as a bridged plug-in. If you have "Preferences → Plug-ins → Compatibility → VST bridging/firewalling" set to "In separate plug-in process" or "In dedicated process per plug-in", you will need to add an exception for Helgobox by setting "Run as" to "Native only"!

Update to the latest stable version

Helgobox development moves fast. In order to take advantage of new features, improvements and fixes, you should check for updates from time to time.

  1. Extensions → ReaPack → Synchronize packages

    • It will tell you if a new version has been installed.

  2. Restart REAPER

Important note for Linux users

  • You also need libxdo installed, otherwise ReaLearn won’t scan.

  • Debian/Ubuntu: sudo apt-get install -y libxdo-dev

Test new features and improvements

If you want to get access to cutting-edge but untested versions of Helgobox, you have two options:

Install a specific pre-release:

  1. Right mouse click on the Helgobox package → Versions

  2. Select any version ending on -pre. or -rc.

  3. OK or Apply

  4. Restart REAPER

Enable pre-releases globally:

  1. Extensions → ReaPack → Manage repositories → Options… → Enable pre-releases globally (bleeding edge)

  2. After that, whenever you synchronize packages, you will get the latest stuff.

Usage

Quick start

Helgobox is fired up just like any other VST instrument in REAPER: By adding it to an FX chain.

Initially, you see the Helgobox plug-in, which mainly provides the ReaLearn user interface:

screenshot main panel annotated
Figure 1. Main panel (containing the list of mappings)
screenshot mapping panel
Figure 2. Mapping panel (for editing one particular mapping)

But there’s also the Helgobox app, which mainly provides the Playtime user interface. You can open it either from the plug-in’s menu or by using the convenient "Playtime" button in the main toolbar.

Videos

ReaLearn

The ReaLearn Tutorials is a fairly new ongoing series of short video tutorials available.

There’s also a long introduction video from 2021. Watch 2 minutes to get a first impression and stay tuned if you are interested in the details.

User guide

ReaLearn

ReaLearn features a large and complete user guide.

Tip
The main focus of ReaLearn’s user guide is being comprehensive, so it’s more like a reference manual and can get quite detailed and technical. If you prefer a simple hands-on approach, the tutorial videos are a better choice.

Supported controllers

ReaLearn is designed to be generic and support any controller. That’s why you won’t find a definitive list of supported controllers! But there’s a list of tested controllers.

Tip
Keep in mind: Even if your controller is not on the list, you probably can make it work with ReaLearn!

Available presets

Architecture

Contributing