Scatter Reference

Overview

Scatter (ABS_Scatter.lua) assigns randomized audio files to child tracks at the edit cursor. It scans a root directory, matches files against per-track filters, and assigns one result per track per roll.

Usage

  1. Select a parent track with child tracks in your REAPER session
  2. Place the edit cursor where you want items to be inserted
  3. Open Scatter via the Actions list or your assigned shortcut
  4. Set the library root path and per-track file filters
  5. Click Roll All to assign files

Assignment Modes

| Mode | Behavior | |------|----------| | FREE | Each track picks independently. Duplicate files across tracks are allowed. | | UNIQ | Each track gets a unique file. No file appears on two tracks in the same pass. | | LOCK | Track keeps its current file. Excluded from the roll. |

Presets

Save your current configuration (root path, per-track filters and modes) as a named preset. Presets are stored in the REAPER resource path and survive project changes.

Requirements

  • REAPER 7.x
  • ReaImGui 0.9.x
  • js_ReaScriptAPI (optional — improves Ctrl+Z focus return)