Skip to main content

Reaper

Setup​

note

The following instructions are given for Reaper v7.27. Reaper is frequently updated by its developer, therefore the instructions might vary slightly from version to version.

Prerequisite: SWS/S&M extension​

Download and install the SWS/S&M extension for REAPER.

Windows: simply run the installer.

macOS:

  1. Download: select ARM64 if using Apple M processors or X64 if using Intel processors.

  2. Launch the installer.

    SWS Extension installer window

  3. Drag and drop reaper_sws-PROCESSOR.dylib into the /Library/Application Support/REAPER/UserPlugins folder. If the folder does not exist, create it manually. The other files are not required for the LIOBOX² to run.

    The dylib in the UserPlugins folder

  4. Launch REAPER.

note

If a security alert pops up and prevents Reaper from opening properly because of the library you just copied, go to macOS Settings → Privacy & Security. Close Reaper, then scroll down until you reach the request to authorize the library anyway. When Reaper is launched again, make sure to Open the SWS library.

macOS Privacy & Security: the SWS library was blocked, click Allow Anyway

To validate that the SWS/S&M plugin is properly installed, open Extensions in Reaper. The SWS/S&M menu shall be present:

The SWS/S&M entry in the Extensions menu

Reaper preferences​

Go to Options → Preferences.

  • Media section: disable Set media items offline when application is not active.

    Reaper Media preferences

  • Audio section: disable Close audio device when stopped and application is inactive.

    Reaper Audio preferences

  • Audio → Playback section: disable Stop/repeat playback at end of project.

    Reaper Playback preferences

LIOBOX² configuration​

  1. Audio → MIDI Inputs: enable All for the "Liobox ***" device.

    MIDI input devices with All enabled for the Liobox

  2. Audio → MIDI Outputs: enable Enable for the "Liobox ***" device.

    MIDI output devices with Enable ticked for the Liobox

  3. Audio → MIDI Outputs: disable Reset on: Play.

    MIDI outputs with Reset on Play unticked

warning

The script searches for the LIOBOX² by checking whether a MIDI device name starts with "LIOBOX". If your LIOBOX² alias name is different (often the case on macOS), you can change it by double-clicking on the device. Ensure one and only one peripheral starts with "LIOBOX".

Configure MIDI Input dialog with the alias name field

Script​

  1. Ensure the SWS/S&M extension for Reaper is installed. It can be checked in the upper ribbon, under Extensions.

    SWS/S&M under Extensions

  2. The script folder can be loaded from anywhere on a local drive. Avoid virtual or synced drives, such as Google Drive folders. We recommend copying the script folder to <path to Reaper>\InstallData\Scripts.

    tip

    In the GoorooLink Reaper view, browse to the folder containing the scripts so that GoorooLink can detect their version and update them.

  3. Show the action list in Actions → Show action list…

    Actions menu with Show action list

  4. Load the script LioboxMaster.lua by clicking New action… → Load ReaScript…

    Actions window with the New action menu open

    The script should now appear in the script list:

    LioboxMaster.lua in the action list

The script can be executed:

  • On request (launched directly)
  • At project opening
  • At Reaper opening

To launch the ReaScript when a project or Reaper opens:

  1. Copy the loaded ReaScript Command ID by right-clicking on the script and selecting Copy selected action command ID.

    Context menu with Copy selected action command ID

  2. Type "startup" in the filter bar.

    Action list filtered on &quot;startup&quot;

  3. Depending on whether the script is to launch at project or Reaper startup, select Set project startup action (or Set global startup action) and paste the Command ID.

  4. A confirmation popup indicates that the previous step succeeded.

    Confirmation that the script is defined as project startup action

Other​

  • To remove the automatic loading of the script, use Clear global startup action or Clear project startup action.
  • To display the project or global startup action, launch the command Show project/global startup actions.
  • To execute the script only once: in the Actions list window, select the script and click Run.
note

If the LIOBOX² does not appear, ensure it is connected prior to launching Reaper.