Version
menu_open

Open Associated REAPER Project

Open Associated REAPER Project is a REAPER scripts package that makes it easy to open the REAPER project associated with the source WAV file of a Sound SFX in Wwise. Open Associated REAPER Project uses the metadata embedded in the source file to locate the project and time offset of the source.

Open Associated REAPER Project is available in the Audiokinetic Reaper Tools Repository and is installed using the ReaPack package manager.

Requirements

Minimum version of REAPER: v6.80

Before rendering files in REAPER, ensure your rendered files will include the required metadata:

  1. From the REAPER menu bar, click File > Project Render Metadata.

  2. In the dialog that opens, select the following:

    • Embed title/date/time if not provided

    • Embed start offset (media position in project)

    [Note]Note

    If you use Strata and implemented the Recommended REAPER Settings, you will have Calculate and embed peak/loudness values selected as well. You can leave it selected.

  3. Note, this step is only required if you are not a Strata user since Strata subprojects are configured with this metadata by default.

    From the Scheme list, select IXML. Then double-click the Value field in the User Defined row, type trackName=$track, and press Enter.

    A new row is added to the table.

Installing Open Associated REAPER Project through ReaPack

You must use the ReaPack package manager in REAPER to install Open Associated REAPER Project. If you have already installed ReaPack and Audiokinetic’s Reaper Tools repository, you can proceed to step 4.

  1. Go to ReaPack: Package manager for REAPER to download ReaPack. Refer to the ReaPack User Guide for installation instructions.

  2. After ReaPack is installed, from the REAPER menu bar, click Extensions > ReaPack > Import Repositories.

  3. In the dialog that opens, enter the URL of Audiokinetic's Reaper Tools repository (https://github.com/Audiokinetic/Reaper-Tools/raw/main/index.xml) and click OK.

  4. From the REAPER menu bar, click Extensions > ReaPack > Browse packages.

  5. In the dialog that opens, right-click OpenAssociatedReaperProject and select the version you want to install.

  6. In the lower-right corner of the dialog, click Apply.

    The OpenAssociatedReaperProject package is downloaded and moved to the REAPER OpenAssociatedReaperProject Scripts directory.

  7. From the REAPER menu bar, select Actions > Show actions list.

  8. In the Actions list, select Open Associated Reaper Project_Install Wwise Command.lua and click Run.

  9. If Wwise is open, close and restart it.

    The custom command Open Associated REAPER Project is added to the shortcut menu of all Sound SFX objects in Wwise and your REAPER projects root directory is configured.

    [Note]Note

    If you change your REAPER projects root directory, rerun the action.

Using the Wwise Command

In Wwise, right-click a Sound SFX object that has a source WAV file that was rendered in REAPER. Then click the Open Associated REAPER Project command.

The REAPER project associated with the Sound SFX opens and the timeline is positioned at the beginning of the source region.

Known Issues

  • If REAPER is not running when you execute the Wwise command, the track view might scroll back near the top-left corner if other windows are docked to the main window.

Troubleshooting

  • The Open Associated REAPER Project command is not available in the shortcut menu of Sound SFX objects in Wwise:

    • You must restart Wwise after installing the command.

  • The Open Associated REAPER Project command opens REAPER but does not open the REAPER project associated with the WAV file:

    • Open Associated REAPER Project depends on a new feature added to REAPER in v6.80. Make sure you have this version or later.

    • Open Associated REAPER Project needs the start offset and title metadata embedded in the rendered file. Make sure Embed title/date/time if not provided and Embed start offset (media position in project) are selected in the REAPER Project Render Metadata dialog before rendering files.

    • The Open Associated REAPER Project command is added to the shortcut menu of all Sound SFX objects in Wwise, including those whose source WAV file was not rendered in REAPER. Ensure the source WAV file of the Sound SFX object you selected was rendered in REAPER.

Open Associated REAPER Project Release Notes

This section contains all the release notes for Open Associated REAPER Project.

1.0.0

  • Initial release.


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise