mcp_opendaw_move_section
Move all regions within a beat range to a new position, replacing multiple delete and create steps with a single non-destructive operation for restructuring arrangements.
Instructions
Move all regions within a beat range to a new position (non-destructive rearrangement).
Scans all tracks across all specified audio units, finds every region that overlaps the [from_beat, to_beat) range, and moves each one to target_beat with the same relative offset. Unlike duplicate_section, this removes the original — a true cut-and-paste operation.
This is the arrangement tool for restructuring: "move the bridge from bar 33 to bar 17" or "shift this 4-bar fill 8 bars earlier". One call replaces N delete + N create sequences.
from_beat: Start of the source section in beats. to_beat: End of the source section in beats (exclusive). target_beat: Where to move the section (beat 0 = start of project). unit_indices: Comma-separated AU indices to scan (default: all AUs).
Returns number of regions moved, per-track details, and old/new positions.
Examples: move_section(from_beat=32, to_beat=48, target_beat=16) -> Move bars 9-12 to bar 5 (shift 16 beats earlier) move_section(from_beat=0, to_beat=16, target_beat=32, unit_indices="0,1") -> Move first 4 bars from AUs 0,1 to beat 32
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_beat | Yes | ||
| from_beat | Yes | ||
| target_beat | Yes | ||
| unit_indices | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |