Stephen Cruz

Report 03 / Max for Live

Song Import Consolidation

Move imported song material into the working playback template without deleting the source or creating a complete-looking but invalid result.

Status
Built; self-tested and syntax-checked
Category
Max for Live
Built with
Max for Live / Ableton Live 12 / Live API / Max JavaScript
Workflow signal4 stages
ScanInspect the imported song groupRead the source lanes and cache track children and Arrangement clips for the current scan.
MapMatch clips to template destinationsRoute lyrics by name first, then use the configured color and lane rules for the remaining material.
CheckStop on unsafe conditionsBlock overflow, unmapped color, destination overlap, or incompatible clip and destination types.
DuplicateCopy clips and preserve the sourceDuplicate existing Arrangement clips as-is, mark processed tracks or groups, and mute the processed source song group.

Blocker: Overflow, unmapped color, destination overlap, and incompatible clip or destination types stop the operation before duplication.

Song Import Consolidation moves imported song-group Arrangement clips into Stephen’s fixed worship playback template.

The device scans the imported structure, maps its lanes to the template, checks capacity and overlap, and duplicates existing Arrangement clips as-is. It does not use Ableton Consolidate, delete the source clips, or delete the source tracks. After a successful operation, processed tracks and groups are marked [MOVED], and the source song group is muted.

Lyric tracks are routed by name to LYRICS +LYRICS before color-based routing. When that destination is a group, lyric tracks use its child lanes in order.

The device processes one imported song group per scheduler tick rather than copying the entire set in one blocking pass. Per-scan track children and Arrangement clips are cached for larger sessions.

Its most important behavior is where it stops. Overflow, unmapped destinations, overlap, or incompatible clip and destination types become blockers. The device does not trade an obvious incomplete import for a polished-looking mistake.