ReaKontrol

• Fork of the excellent ReaKontrol repository originally published by James Teh: https://github.com/jcsteh/reaKontrol
• Fork Author: brumbear@pacificpeaks
• Fork Copyright: 2019-2020 Pacific Peaks Studio, see individual copyrights in source code
• OSX contributions by Björn Kalkbrenner: https://github.com/terminar
• License: GNU General Public License version 2.0.
• License Notes: As the original work is published under GPLv2 the modified programs are also licensed under GPLv2. May be updated to GPLv3 if copyright holder of original work agrees to update too.

Feature Integration & Releases

• New features will be merged continously into this fork's master @ https://github.com/brummbrum/reaKontrol
• Testing and calibration is done with NI S-Series Mk2 Komplete Kontrol Keyboard.
• Stable releases are published together with binaries (Windows only) in a dedicated release branch: https://github.com/brummbrum/reaKontrol/releases

Manual

• Can be found under releases: https://github.com/brummbrum/reaKontrol/releases

Building

This section is for those interested in building ReaKontrol from source code. The build instructions have changed from the parent repository, this section will reflect these changes, cmake is now used for better cross platform maintenance and syntax highlighting + support in IDEs (and less dependencies).

Getting the Source Code

The ReaKontrol Git repository is located at https://github.com/brummbrum/reaKontrol.git. You can clone it with the following command, which will place files in a directory named reaKontrol:

git clone https://github.com/brummbrum/reaKontrol.git

Dependencies

To build ReaKontrol, you will need:

• CMake, version 3.12 or later:
  • Download CMake

Specific Windows dependencies

• Microsoft Visual Studio 2017 Community:
  • Visual Studio 2019 is not yet supported.
  • Download Visual Studio 2017 Community
  • When installing Visual Studio, you need to enable the following:
    • On the Workloads tab, in the Windows group: Desktop development with C++

Specific OSX dependencies

• Command Line Tools for Xcode

How to build on Windows with VS 2017

To build ReaKontrol, from a command prompt, change to the ReaKontrol checkout directory and run the following commands:

cd build
cmake .. -A x64
cmake --build . --config Release

The resulting dll can be found in the build/bin/Release directory (Windows) Note: If you are still building for Reaper x86 32bit specify -A x86 as target architecture above.

How to build on OSX

Intel x86 based Mac

To build ReaKontrol, from a command prompt, change to the ReaKontrol checkout directory and run the following commands:

cd build
cmake .. 
cmake --build . --config Release

The resulting dylib can be found in the build/lib directory (OSX).

ARM based Mac

First, comment out 'set(CMAKE_OSX_ARCHITECTURES x86_64)' in 'CMakeLists.txt'. Then build as described above.

Both ARM and x86 binaries can reside in parallel and load depending on Rosetta settings by naming them like this:

ls ~/Library/Application\ Support/REAPER/UserPlugins

reaper_kontrol-x86_64.dylib
reaper_kontrol.dylib

How to Install

If you have followed the build steps, you can attach the last command:

cmake --build . --target install

The rea_kontrol.dll is then copied to your

• Win32: %APPDATA%/Reaper/UserPlugins
• OSX: $home/Library/Application Support/Reaper/UserPlugins folder.