Known Limitations

REAPER Version Requirements

| Requirement | Details | |-------------|---------| | Minimum version | REAPER 7.0 | | Recommended version | REAPER 7.x (latest stable) | | Unsupported | REAPER 6.x and earlier |

Temper scripts are validated against the current REAPER 7.x stable release. REAPER 6.x introduced significant API changes that are not backport-compatible with our validation pipeline.

If you are on REAPER 6.x, upgrade to 7.x before installing. A free REAPER license covers all versions.

Required Extensions

All Temper scripts require the following extensions. Scripts will not launch without them.

ReaImGui

All Temper scripts use ReaImGui for the GUI layer.

  • Minimum version: ReaImGui 0.9.x
  • Install via: ReaPack (search ReaImGui)
  • What happens without it: Script opens and immediately closes with no error message visible, or throws a console error referencing ImGui.

Optional Extensions

js_ReaScriptAPI

Not required to run scripts, but improves behavior:

  • After closing a Temper script window, keyboard focus returns to the correct REAPER window without a manual click.
  • Without it, you may need to click the REAPER arrange view to regain keyboard focus after closing a script.

Install via ReaPack (search js_ReaScriptAPI).

SWS Extension

Not required by any Temper script. Recommended as a general quality-of-life addition for REAPER.

Scatter-Specific Limitations

File format support

Scatter assigns files based on filename matching only — it does not inspect audio content. Any file in the library directory will be considered a match regardless of format. REAPER handles format compatibility at playback.

Tested formats: .wav, .aiff, .flac, .mp3, .ogg.

Directory depth

Scatter scans the library root recursively with no depth limit. Very large libraries (10,000+ files) may cause a brief pause on initial scan.

Track hierarchy

Scatter operates on direct child tracks of the selected parent only. Grandchild tracks (nested further) are not included in the roll.

Item placement

Scatter inserts items at the current edit cursor position. It does not overwrite or move existing items — it inserts new items in place. You will need to delete or manage previous items manually if re-rolling at the same position.

Undo granularity

Each Roll All creates a single REAPER undo point. Individual track assignments within a roll cannot be undone separately.

Mouse modifier conflicts

Scatter assumes standard REAPER mouse modifier defaults. Heavy customization of mouse modifiers may produce unexpected item behavior when Scatter inserts items.

OS Compatibility

| OS | Status | |----|--------| | Windows 10 / 11 | Fully supported | | macOS 12+ (Monterey and later) | Supported — see macOS notes below | | macOS 11 (Big Sur) | Best effort | | Linux | Untested |

macOS Notes

  • Gatekeeper: On first run, macOS may block the script with "cannot be opened because the developer cannot be verified." See Troubleshooting for the bypass procedure.
  • Retina display: ReaImGui renders at full resolution on Retina displays. No scaling issues known.
  • Apple Silicon (M1/M2/M3): Supported via REAPER's native ARM build. No Rosetta 2 required.

Known Incompatibilities

| Scenario | Status | |----------|--------| | REAPER 6.x | Not supported | | ReaImGui versions below 0.9 | Not supported — upgrade via ReaPack | | Scripts that heavily patch REAPER's item insertion behavior | May conflict — test in a clean environment | | Third-party themes that override REAPER's default mouse modifiers | May affect item insertion behavior |

Reporting Issues

If you encounter behavior not covered here, report it in the Temper Discord #bug-reports channel using the pinned template. Include your REAPER version, OS, ReaImGui version, and steps to reproduce.