Download

• 

  Windows Installer

  Version:	1.7.1
  File type:	exe
  File size:	2.8 MB
  Checksum:	SHA-512
  Language:	English
  System requirements:	Windows XP, Vista, 7, 8 or 10, 32-bit or 64-bit REAPER >= v5.40, 32-bit or 64-bit
  Installation:	Internet Explorer or Edge might show the warning The signature of realearn-v1.7.1-installer.exe is corrupt or invalid. This is most likely a false alarm. In that case, just click "View downloads", right click on the file and choose "Run anyway". On Windows 8 and 10, the SmartScreen filter might also complain when you try to start the installer: Windows protected your PC. In that case, just click "More info" and then "Run anyway".
  Portable:	The installer doesn't support portable REAPER installations. If you want to add ReaLearn to a portable REAPER installation, download one of the following ZIP files and extract the contents of the REAPER directory within the ZIP file into the REAPER directory of your portable REAPER installation. The ZIP file must match the architecture of your portable REAPER installation (32-bit or 64-bit). realearn-v1.7.1-portable-win-32-bit.zip realearn-v1.7.1-portable-win-64-bit.zip

• 

  Mac OS X Installer

  Version:	1.7.1
  File type:	pkg
  File size:	5.8 MB
  Checksum:	SHA-512
  Language:	English
  System requirements:	Mac OS X >= 10.7, 32-bit or 64-bit REAPER >= v5.40, 32-bit or 64-bit
  Installation:	On Mac OS X >= 10.8, Gatekeeper might refuse to start the installer: realearn-v1.7.1-installer.pkg can't be opened because it is from an unidentified developer. In that case, just locate the downloaded installer in Finder, right- or CTRL-click it and choose "Open" from the context menu. When the warning appears, click the "Open" button to confirm that you wish to use the installer.
  Portable:	The installer doesn't support portable REAPER installations. If you want to add ReaLearn to a portable REAPER installation, download the following ZIP file and extract the contents of the REAPER directory within the ZIP file into the REAPER directory of your portable REAPER installation: realearn-v1.7.1-portable-osx.zip

Donate

Docs

Quick start:

1. Download ReaLearn, install it and start REAPER
2. Make sure you have enabled the MIDI devices that you want to use with ReaLearn in the REAPER preferences ("Enable input from this device"). It's not necessary to enable input for control messages.

3. Add a track, arm it for recording (or at least enable input monitoring) and open its input FX chain

   

4. Add VSTi "ReaLearn (Helgoboss)"

5. Add a mapping

   

6. Edit the new mapping

   

7. Press the "Learn source" button and move a fader on the MIDI controller

   

8. Press the "Learn target" button and move the track's volume knob in REAPER

   

9. The fader should now control the track's volume

10. Make your life easier by using one-click MIDI learn: Create a toolbar button for the action "ReaLearn: Learn source for last touched target" (available as long as at least one ReaLearn FX loaded)

    

Community

• Forum (dedicated REAPER forum thread)
• Issue tracker (Bitbucket)

Contribute

• If you want to report a bug or suggest a feature, please go to the ReaLearn issue tracker and have a look whether the issue has already been reported. If not, create an issue of type bug or proposal.
• If you experience a crash caused by ReaLearn, please provide the information mentioned here on the ReaLearn issue tracker.
• You can easily vote for existing feature proposals if you are logged in to the issue tracker.
• If you want to give general feedback, please do it in the forum.
• If you want to show appreciation for the project, you are welcome to make a donation.

Credits go to

• Cockos for writing REAPER, a really great DAW

• Oli Larkin for maintaining IPlug

Changelog

1.7.1 2018-08-08

• #159 Added possibility to use ReaLearn on master track

• #160 Improved 'FX must have focus' by sending feedback when FX gets focus

1.7.0 2018-08-06

• #134 Added possibility to select '<Any>' as source note, CC and channel

• #157 Improved usability by always displaying track/FX/parameter positions and MIDI device IDs in labels and dropdowns

• #150 Improved usability by ignoring FX reordering and removal whenever '<Selected>' is chosen for track targets. That just makes more sense. So there's not such a tight connection to the FX anymore in this case. It will use whatever FX is at the position and if there is none it won't do anything.

• #139 Improved usability by automatically scrolling mixer when selecting track via 'Track selection' target

• #149 Improved usability by also displaying disconnected MIDI devices in REAPER >= 5.94 (if you think there are so many now that it gets confusing, it's time to clean up in REAPER => Preferences => Audio => MIDI Devices by using the 'Forget device' operation ;)

• #140 Improved processing by completely disabling feedback and control (even if coming from direct hardware device) whenever ReaLearn FX is disabled

• #143 Improved processing by disabling 'MIDI thru' if MIDI control input comes directly from a hardware device (so ReaLearn will now only forward MIDI messages to its FX output if they come from its FX input)

• #147 Improved processing by reliably detecting if FX change occurred on input FX chain or normal FX chain for REAPER >= 5.95pre1

• #148 Improved performance in some cases by using new function in REAPER >= 5.95pre1 to look up the project for a given track

• #155 Improved performance in some cases by never creating an undo point when arming/disarming ReaLearn track

• #133 Improved usability by adding a remark to targets 'Track FX enable' and 'Track mute' that they don't provide feedback from automation changes (currently not possible, capability needs to be added on REAPER side)

• #151 Fixed non-working relative mode for probably most JS FX, also fixed detection of discrete FX parameters

• #142 Fixed crash when using a fader after having removed a ReaLearn instance with direct hardware device input

• #144 Fixed OS X crash related to MIDI device API changes in REAPER 5.94 (also fixed in REAPER 5.941)

• #145 Fixed confusing OS X MIDI device dropdown behavior if device is not known by explicitly displaying a temporary entry '<Unknown>' instead of just displaying the first entry in the dropdown

1.6.1 2018-07-06

• #128 Added possibility to apply a track target to the currently selected track (via new track option '<Selected>'; also renamed '<Current>' to '<This>' to make more clear what is meant)

• #129 Added possibility to receive MIDI directly from device (via 'MIDI control input' dropdown, good for example if you want to use the track input for something else such as recording audio)

• #130 Improved mapping window size and layout so that things don't get cut off

• #131 Improved usability by graying out 'Send feedback only if track armed' if ReaLearn is on input FX chain (because then feedback is always only sent if track armed)

1.6.0 2018-07-05

• #122 Added 'Track FX preset' target for navigating between FX presets (no value feedback because REAPER's API doesn't notify extensions about preset changes)

• #121 Added 'Track FX enable' target for enabling/disabling track FX

• #123 Added possibility to change mapping name

• #124 Added source min/max also to toggle mode (used for feedback only)

• #125 Improved track arm, mute, select and solo target types by triggering them as soon source value > source min value (doesn't have to be source max value anymore)

• #126 Improved mode reset and auto-detection for targets with discrete values by choosing sensitive default values for step sizes

• #127 Fixed rotate option and made it more simple/predictable

1.5.3 2018-06-26

• #119 Added playrate target

• #120 Fixed track selection for track arm target

• #118 Fixed non-working ReaLearn on 32-bit REAPER installations

1.5.2 2018-06-21

• #115 Improved control performance (significant improvement, ReaLearn shouldn't cause any crackling anymore when doing fast fader movements)

• #116 Improved feedback performance

• #114 Improved performance on load and when reordering FX

1.5.1 2018-06-15

• #109 Fixed showstopper crash related to orphan mappings

• #108 Fixed potential crash when closing project or exiting REAPER

• #112 Fixed crash and issues with current track functionality in some situations (e.g. when instantiating track templates containing both ReaLearn and Kontakt in a second project tab)

• #111 Fixed 'Learn source for last touched target' action so it supports the recent new target types

• #110 Fixed mute and solo targets so value changes also inform other control surfaces

1.5.0 2018-06-11

• #67 Added possibility to export and import all ReaLearn settings to and from clipboard (e.g. useful for exchanging presets and doing batch modifications of ReaLearn settings via text editor)

• #16 Added support for transforming incoming (control) and outgoing (feedback) values in absolute mode via mathematical functions (EEL is used, the same language which REAPER uses for JS effects - that let's you do all kind of interesting things, is more usable than putting a JS MIDI effect in front of ReaLearn and it gives you the complete target parameter precision because you deal with 64-bit floating point numbers instead of the usual 7-bit MIDI message precision; x is the incoming control value, y is the target value, both are numbers between 0 and 1; for example a control transformation 'y = 1 - x' creates a reverse effect)

• #101 Added master tempo target (it was possible before to change REAPER tempo by using an action target but you didn't get feedback and BPM rounding)

• #73 Added track selection target (you can also select a track exclusively)

• #54 Added mute and solo track targets

• #86 Added track send pan target

• #100 Added 'MIDI clock transport' source (for receiving play/continue/stop messages directly from MIDI hardware inputs; they can be mapped to transport actions in REAPER in order to make REAPER a MIDI clock slave regarding transport control)

• #100 Added very experimental 'MIDI clock tempo' source (if you map this to the new 'Master tempo' target, you can turn REAPER into a MIDI clock slave regarding project tempo; but don't expect too much, the resulting tempo is currently unstable; IMHO a much better method if you want REAPER tempo to reflect the tempo of e.g. Ableton Live, is to create a ReaLearn mapping with a 'CC value' source and a 'Master tempo' target with target min = 73 bpm and max = 200 bpm and to let Ableton Live send tempo feedback using the same CC and tempo range ... this combined with native REAPER SPP sync and you have instant tempo and song position changes; whereas MIDI clock tempo sync has an inherent delay due to its nature)

• #77 Added track target option 'Track must be selected'

• #26 Added absolute mode option 'Slowly approach if jump too big (scale mode)' (of course only has an effect if max jump is small enough)

• #102 Added absolute mode option 'Min jump' to also let users specify a minimum parameter jump, not only a maximum one

• #101 Added absolute mode option 'Round target value' for supported targets (currently only 'Master tempo', in order to round to integer BPM values)

• #92 Added button to send MIDI feedback manually

• #80 Added zip file downloads to website to be used for portable REAPER installations

• #91 Added feedback option 'Send only if track armed' (enabled by default for new presets because it makes sense; if ReaLearn is on the input FX chain, feedback is never sent if the track is disarmed)

• #97 Added source and target filtering to mapping list window in order to let users find existing mappings easier (e.g. to quickly check if a particular mapping is already there)

• #72 Added buttons for moving mapping up or down

• #106 Added 'Find in mapping list' button to edit mapping window

• #107 Added checkboxes for enabling/disabling control/feedback also to edit mapping window

• #88 Added mapping numbers for being able to better identify mappings (especially after duplicating a mapping)

• #83 Improved Windows installer by making it more predictable and easier to use (user doesn't have to choose the VST directory anymore, ReaLearn will always be installed into a fixed dedicated VST directory, REAPER VST scanning path will be modified if necessary so the ReaLearn VstPlugins directory is the last one ... last one has highest priority, so old installed versions are just ignored)

• #61 Improved usability by closing mapping dialog when pressing escape key

• #84 Improved mapping list window performance if there are many mappings

• #78 Improved preset reusability by discovering tracks by name if they are not found by their unique GUID (that way one and the same ReaLearn preset can be used in different projects as long as those projects have tracks with the same names)

• #89 Improved scrolling behavior

• #105 Improved usability by not closing mapping edit windows when closing ReaLearn mappings window (not needing to leave the mappings window open saves screen space)

• #90 Improved usability by marking REAPER project as dirty when changing something within ReaLearn

• #104 Improved usability by making it possible to enter step counts and step sizes of discrete target parameters directly instead of having to enter percentages (also removed the decrease/increase buttons because they are not really useful anymore after this change)

• #103 Improved usability by making it possible to enter target values directly instead of having to enter percentages (only for supported targets, FX parameters for example don't support this)

• #96 Improved control behavior by ignoring NOTE OFF messages sent by REAPER when pressing play (those messages make absolute sense for stopping VST instruments from sounding but they accidentally reset target parameters when using ReaLearn)

• #82 Fixed buggy installer on Mac OS X

• #81 Fixed problem that caused ReaLearn not to work in 32-bit REAPER installations on Mac OS X

• #70 Fixed possible crash when learning target

• #50 Fixed cropped window when using scaling on Windows (e.g. on HiDPI screens)

• #76 Fixed bug in 'Auto-detect mode' that caused a wrong mode to be restored when loading a project or preset

• #93 Fixed bug that could cause feedback MIDI messages to pile up while track disarmed or audio device off

• #94 Fixed potentially incorrect feedback message for first target change after loading ReaLearn

• #95 Fixed 'FX must have focus' not being respected for feedback

• #98 Fixed crash after deleting track send used in track send target and opening ReaLearn window again

• #99 Fixed weird scrollbar on OS X

1.1.0 2017-12-10

• #41 Added experimental support for MIDI feedback (supported sources: CC value, note velocity, pitch wheel, channel after touch, program change, polyphonic after touch ... (N)RPN currently not; supported modes: absolute, toggle; supported targets: all, limited support for actions)

• #56 Added possibility to enable/disable each mapping (control and feedback can be enabled/disabled separately - this feature makes it possible to correctly handle devices that expect different kinds of MIDI messages for feedback than they send when moving a control)

• #68 Added possibility to go to target (e.g. scroll to track, open FX, ...) via 'Go there' button in mapping window

• #53 Added target 'Track arm'

• #57 Added source 'Polyphonic after touch'

• #64 Added possibility to learn action target (so you don't have to choose the action in the long dropdown menu; just invoke the action while having 'Learn target' enabled and it will be selected)

• #65 Added target visualisation for on/off actions

• #58 Fixed bug that caused control surfaces to not be notified when volume and pan was changed through ReaLearn

• #62 Fixed REAPER UI lags when using target value visualisation in mapping dialog

• #63 Fixed serious audio and UI lags when having many targets under load

• #60 Fixed audio crackling when opening ReaLearn UI

• #66 Fixed non-working send volume target learning and visualisation

• #59 Fixed some possible crashes (e.g. when loading ReaLearn in inactive project tab, when deleting tracks used in ReaLearn, when removing FX used in ReaLearn)

1.0.2 2017-02-05

• #51 Fixed incorrectly displayed target track in dialog window (always showed previous track)

1.0.1 2016-12-24

• #49 Fixed critical timing bug that caused MIDI messages to be forwarded (let through) slightly delayed

1.0.0 2016-12-23

• #45 Added option "FX must have focus" to FX parameter target

• #48 Fixed UI freeze on Windows when using action target by loading the complete set of action names not before clicking action dropdown

• #43 Fixed superfluous invocation of trigger-style actions when releasing a MIDI switch (note or CC) by making it possible to specify an invocation type and making "Trigger" the default type (because most actions have trigger character)

• #46 Fixed UI freeze when using (N)RPN source by replacing dropdown with text field

• #44 Fixed unnecessary reload of action list

1.0.0-beta6 2016-11-17

• #39 Improved invocation speed of actions

• #40 Fixed still broken restoral of custom action targets

1.0.0-beta5 2016-11-11

• #33 Improved usability by allowing input of source min/max values as discrete values, not as percental ones (that allows for far more precise setups)

• #29 Improved usability and comprehensibility by working with percental values instead of values between 0 and 1

• #28 Improved range of usable CCs: CCs 6, 38, 98, 99, 100 and 101 are now usable if (N)RPN is not used on that channel

• #35 Improved stability by deferring to main thread much earlier in the processing chain

• #20 Improved usability by not using more screen space than necessary, for example by reducing the space between mapping rows

• #37 Improved supportability by including information about beta version in DLL file

• #25 Fixed broken restoral of custom action targets

• #30 Fixed broken text input for target value

• #32 Fixed bug that caused the pitch wheel to never reach the highest possible value

• #22 Fixed crash on REAPER project load after ReaLearn FX was renamed

• #23 Fixed display of dummy values and incomplete values on REAPER project load for send volume targets

• #31 Fixed bug that caused soft takeover (max jump) to lose track of the value and therefore misbehave

• #34 Fixed REAPER freeze when writing send volume automation while FX multiprocessing enabled

• #38 Fixed flipped UI in OS X ('Add mapping' button and checkboxes were on the buttom but they should have been on the top like on Windows)

1.0.0-beta4 2016-08-04

• #11 Added new source '(N)RPN' for MIDI (N)RPN messages (both 7 and 14 bit)

• #13 Added support for 14-bit CCs

• #14 Added 'Max jump' slider to absolute mode for controlling soft-takeover behavior (also known as 'pickup')

• #10 Fixed bug that caused volume control to be non-linear (now behaves exactly like the volume control action)

• #12 Fixed action target so user interface stays responsive while loading actions

• #15 Fixed REAPER freeze on project load when putting a plug-in in front of ReaLearn which sends MIDI messages

• #17 Fixed weird behavior after duplicating mapping with FX parameter target (and probably also other target types)

• #19 Fixed bug that caused mapping list to be out of date after duplicating tracks

1.0.0-beta3 2016-07-03

• #9 Added new target 'Track pan'

• #8 Added option 'Ignore out-of-range source values' and disable it by default (this only has an effect if you restrict the source range using the min/max sliders)

• #5 Fixed bug that caused ReaLearn to misinterpret parameter modulation and automation as 'touch' events

1.0.0-beta2 2016-06-29

• #3 Added action 'ReaLearn: Learn source for last touched target' for one-click MIDI learn (available as long as at least one ReaLearn FX loaded, I recommend to create a toolbar button for that)

• #4 Fixed REAPER freeze when controlling FX parameter and writing new automation

• #2 Fixed parameter jumps with JS effects

• #1 Fixed pitch wheel range

1.0.0-beta 2016-06-11

• Release of first beta

Roadmap

Additionally

• The issue tracker might give further clues.