Skip to main content
Each line in a block is a separate prompt. Pick one, change the names and numbers to fit your project, and send it. For help writing your own prompts, see Best Practices. Before you send a prompt, check that:
  • REAPER is connected. REAPER is open and the Bridge, the small script that connects Reagent to REAPER, is running. If it isn’t, Reagent can’t see or change your project. See Quick Start or Troubleshooting.
  • The SWS Extension is installed. Reagent needs it to read and edit media items.
  • The right things are selected. “This” and “the selected items” mean whatever is selected in REAPER or Wwise when you send the message. In REAPER, selected items take priority over selected tracks. See Working with Selections.
  • Your permission mode. Default permissions asks before every change (you click Allow or Deny). Auto-review skips asking for a few low-risk changes, such as adding markers with Reagent’s built-in marker tool or renaming files, and asks before the rest. Full access doesn’t ask.
  • Many jobs run as a script. For renaming, coloring, fades and similar jobs, Reagent writes and runs a short ReaScript (a Lua script that controls REAPER). You approve it on a Run script approval card unless you use Full access. See ReaScript.
  • What undo covers. Reagent’s changes to your REAPER project go into REAPER’s undo history, sometimes as several entries per request. Press Cmd+Z on macOS (Ctrl+Z on Windows) once for each entry you want to reverse. REAPER’s undo doesn’t cover rendered files or files that were moved or renamed. See Undo and Recovery.

​
Organize Tracks and Items

Rename tracks and items
Color tracks and items
Add or remove fades
Add markers and regions

​
Silence and Transients

Remove silence from sound effects
Reagent splits each item at every silent gap and removes the gaps, leaving shorter pieces where they were on the timeline.
  • Silence is, by default, anything more than 20 dB quieter than the item’s average level for at least 100 ms. You can set your own values, such as “treat anything below -50 dB as silence”.
  • Pieces shorter than 50 ms aren’t kept.
  • Meant for sound effects. Silence removal can’t tell a pause from the end of a line, so don’t use it on dialogue. See Level and Edit Dialogue instead.
Split, move or mark items at transients and peaks
For a predictable result, name what to line things up with, such as the edit cursor or the first item’s transient.

​
Create Variations

The Create Variations skill copies the selected sound, can swap in alternative recordings you’ve also selected, and randomizes the copies.
How much it randomizes depends on the intensity you name. See Randomization Intensity for the ranges.
  • None changes only what you ask for.
  • Default, used if you don’t name one, gives each copy a random pitch and volume change.
  • High also varies timing, playback rate and pitch over time.
  • Maximum does everything high does, and can also mute, reverse or add stretch markers to some items.
Control what changes Say what should change. Settings you name override the intensity, and everything else still follows it, so add “nothing else” to change only what you name.

​
Level and Edit Dialogue

Level dialogue volume, or ask Reagent to split or trim items at times you give it. Level dialogue volume
The leveler evens out loud and quiet parts by writing a take volume envelope on each item. It analyzes the audio on your computer. See Volume Leveling.

​
Edit Dialogue Automatically

Reagent transcribes the audio, finds each take, and splits, trims and renames the items in REAPER.
Transcription doesn’t run on your computer. Reagent uploads the audio to temporary storage on Reagent’s servers, which send it to ElevenLabs for transcription. For details, including how to show or translate the transcribed lines, see Dialogue. For where the audio goes, see Privacy & Security.

​
UCS Names and Metadata

UCS (Universal Category System) is a public standard for naming and sorting sound effects. Each category has a short code called a CatID, such as VEHCar. Find a UCS category
Reagent listens to the items and suggests a category for each one. Classification runs on your computer and, on a Mac, needs Apple silicon and macOS 14 (Sonoma) or later. See UCS Classification. Rename with UCS names
UCS names follow the pattern CatID_FXName_CreatorID_SourceID. Include your creator ID and source ID, as above, so Reagent doesn’t have to ask. For items in REAPER, Reagent renames the item, not the audio file on disk. To get files with UCS names, render the items. Read metadata
Reagent can’t write metadata into audio files yet. See Writing Metadata.

​
Render Files

  • Reagent’s own formats. WAV at 16-bit, 24-bit (the default) or 32-bit float, or MKV video, at 48 kHz stereo unless you ask for a different sample rate or channel count. No MP3 or FLAC.
  • Not your last render settings. Reagent renders with its own settings, then puts your project’s render settings back.
  • One file per selected item. Rendered files aren’t added to your project.
  • Your folder. “A folder I choose” opens a folder picker. Missing folders are created.
  • Check the approval card. Unless you use Full access, the Render media card shows the format, scope and output folder before anything renders.
For details, see Rendering.

​
Search and Preview

Count and list what’s in your project
Reagent can’t save text files, so it puts CSV and other text in the chat for you to copy into a file. Find and select items and tracks
Check a change before Reagent makes it
For a script, Reagent shows the code in a Create script block. Nothing runs until you click the play button (Run script) in its top-right corner. To keep it as a REAPER action, click the save button (Save to REAPER Actions). Before running a new kind of change on hundreds of items, try it on a few and check the result.

​
Wwise

Wwise Authoring must be open and connected. Questions about your project don’t change anything, and Reagent asks before each change unless you use Full access. See Wwise. Ask about your project, or change it
Mix a sound you just heard in your game First connect Wwise to the running game and start Profiler capture (press F5 in Wwise). See Live Mixing.
To reverse a Wwise change, use Edit > Undo in Wwise. See Undoing Changes.

​
Chain Several Steps

Put several steps in one request. Reagent works through them in order and, depending on your permission mode, asks for approval at each change. Send each block below as one message. Line up a set of hits
Clean up raw sound effect recordings
Prepare sounds for a library
Silence removal can turn each item into several pieces, so you may get more files than the items you selected.
  • If a long chain stops early, ask it to continue. Reagent takes up to 25 rounds of actions in a row, and answering an approval card or a question resets the count.
  • To rerun a chain, save it as a slash command in Settings > Commands with New command, then type / and its name. See Slash Commands.

Best Practices

Write clear prompts and recover when a result isn’t right.

Permissions

Choose when Reagent asks before it changes your project.

Slash Commands

Save a prompt you use often and run it with /.

REAPER Tools

What Reagent can read and change in your REAPER project.