Skip to content

helgoboss/realearn

Repository files navigation

ReaLearn

Installation

The easiest and preferred way of installing ReaLearn is via ReaPack, a sort of "app store" for REAPER. It allows you to keep your installation of ReaLearn up-to-date very easily.

Install for the first time

If you previously installed ReaLearn manually, please uninstall it first!

  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 realearn

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

  7. OK or Apply

  8. Restart REAPER

Linux users only:

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

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

Update to the latest stable version

ReaLearn 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

Test new features and improvements

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

Install a specific pre-release:

  1. Right mouse click on the ReaLearn 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.

Install manually

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 ReaLearn manually if you plan to use ReaLearn 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 ReaLearn 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 ReaLearn by setting "Run as" to "Native only"!

Usage

Quick start

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

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)

Videos

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 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