← Blog August 28, 2022

Grim Sync: Advanced REAPER to Wwise Bridge System

An overview of Grim Sync, the REAPER-to-Wwise bridge that builds on Render Blocks to automate naming, container creation, event generation and iteration.


Grim Sync is a system for connecting REAPER and Wwise, letting you define file names, containers, events, and even object properties. The tool supports importing sounds, voices, and music, with an emphasis on rapid iteration and building complex structures directly within REAPER.

Basic Principle

Grim Sync builds on Render Blocks, a REAPER workflow where groups of items are visually and functionally packed into blocks. Render Blocks provide rendering flexibility, better project organization, automatic naming, and metatags that influence render settings.

Tracks & Regions as Containers

Track hierarchy can generate file names automatically. For example, a hierarchy of Dragon > Fire > Burst > Sizzle produces files like “Dragon_Fire_Burst.wav” and “Dragon_Fire_Sizzle_01.wav”, with indexed naming when duplicates exist.

Grim Sync uses prefixes to represent different Wwise objects:

  • [wu] - Work Unit
  • [f] - Virtual Folder
  • [a] - Actor-Mixer
  • [r] - Random Container
  • [sq] - Sequence Container
  • [sw] - Switch Container
  • [b] - Blend Container
  • [msw] - Music Switch Container
  • [mpl] - Music Playlist
  • [msg] - Music Segment

Using Grim Manager

Grim Manager displays the audio files queued for rendering, previews the designed Wwise hierarchy, creates play and stop events from containers and sounds, and validates existing links to Wwise objects.

Invalid structures — for example, placing an Actor-Mixer inside the Interactive Music Hierarchy — trigger errors that prevent synchronization until you fix them.

Creating Events

Events can be generated automatically from all objects except Work Units, Virtual Folders, and Actor-Mixers. You check the boxes next to containers to preview the resulting event names, with an option for matching stop events, which is useful for loops. Event prefixes and suffixes are customizable through the project settings.

Running the Grim Sync Action

Once you’re happy with the sound and structure design, clicking the GRIM SYNC button renders all files, imports them into Wwise, and creates the containers and events.

Iterating with ReaOpen

ReaOpen is a separate, free tool that locates the original sounds inside REAPER. Right-click a Wwise sound and call ReaOpen to find the corresponding REAPER audio — it opens REAPER and the relevant project automatically, even if REAPER isn’t already running. After editing, running Grim Sync again updates the Wwise sounds.

Customizing Import Locations

By default, sounds import to Actor-Mixer Hierarchy\Default Work Unit, but link regions or link tracks let you specify custom import locations. Event root locations can be customized in the same way.

Linking Sounds to Wwise Objects

This feature permanently links blocks to SoundSFX objects inside Wwise. That means ReaOpen can still find blocks even after they’ve been repositioned on the timeline, and you can make structural changes in Wwise — moving sounds, creating parent containers, renaming SoundSFX objects — without losing the connection back to REAPER.

Validation Process

Validation checks track/region links and linked blocks against Wwise, and only reports errors when objects have actually been deleted. Links work through GUIDs — unique identifiers for each Wwise object — which gives you flexibility to reorganize Wwise without breaking anything.

Wwise Metatags

Metatags are a Render Blocks feature that specify render settings per block, allowing you to render mono, stereo, and surround versions simultaneously with specified loudness and tail length. Wwise Metatags also affect SoundSFX object properties using a hashtag (#) prefix, including Volume, Pitch, Lowpass, Highpass, and InitialDelay.

Creating a Timeline Group

Using Wwise metatags together with the “Add timeline delay metatags to selected blocks” action preserves the relative temporal relationships between sounds in REAPER. Inside Wwise blend containers, those sounds stay in sync without baking silence into the assets.

Smart Subpaths

There are two Smart Subpath types: one for Originals and one for Events. You predefine which container types should be included when organizing sounds within Originals folders or building event hierarchies, whether you want to partially or fully mirror the container hierarchy. Changing the Wwise structure after import affects how Smart Subpaths behave.

Single Items & NVK Folder Items

Although Grim Sync is built around Render Blocks, it also supports single items and NVK Folder items when they’re prefixed with @. This makes Grim Sync useful even if you’re not using the Render Blocks workflow.

Conclusion

As games grow increasingly complex, audio production workflows need to keep up. Grim Sync addresses the limitations of legacy tools by adding flexibility and automation, so sound designers can spend more time on creative work and less time on manual naming, dragging, clicking, and scrolling. A free version is available to try it out.