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

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

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.

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

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

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.

ReaLearn features a large and complete user guide.

• Read it right here on GitHub (preferred, best readability)

• Download user guide as PDF file

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.

• Controller presets

• Main presets