Split Selected Clips at Specified Marker Track

Hi, @Curtis_Macdonald,

Since you are asking about a specific script, I've moved this post to the “Macro and Script Help” section of the forum.

The sf.ui.proTools.memoryLocationsGotoDelta() does not have a property for marker track name, so we have to use a different approach. Typically, you'd use something like sf.app.proTools.memoryLocations.invalidate().allItems.map(memLocs => memLocs.trackName) - however, this seems to currently throw some "null" values for the global marker tracks, which is not very helpful.

Therefore, I'm approaching this differently by utilizing sf.app.proTools.getSessionInfoAsText(). This SDK call can retrieve the session info text you typically get from File > Export > Session Info as Text. This text can include a marker list, including the marker track names. Therefore, I'm filtering that text with some regex (thanks to ChatGPT 😊). From there, we have all the necessary information to make it happen!

Here's the script - I have refactored it a bit to use more SDK calls than UI automation. Set the name of your desired Marker Lane at the top of the script (line 3 below):

// Set the Marker Track Name Here (Markers, Markers 2, Markers 3, Another Track Name...)
let markerTrackName = 'MIX';

////////////////////

if (!sf.ui.proTools.isRunning) throw `Pro Tools is not running`;

sf.ui.proTools.appActivateMainWindow();
sf.ui.proTools.mainWindow.invalidate();

// Get the Session Info as Text - This is how we are getting the markers list with Marker Tracks
let sessionInfoResult = sf.app.proTools.getSessionInfoAsText({
    includeMarkers: true,
    includeClipList: false,
    includePluginList: false,
    includeTrackEdls: false,
    includeUserTimestamps: false,
    includeFileList: false,
})

// Use Regex to Filter for Lines that Start with a Number 
const markerLines = sessionInfoResult.sessionInfo
    .split('\n')
    .filter(line => /^\d+\s+/.test(line)); // lines that start with a number

// Further Split These Lines by their "headers" of Number, Location, Time Reference, Units, Name, and Marker Track Name
// Store this as an array of Marker Objects
const markers = markerLines.map(line => {
    const parts = line.split('\t').map(p => p.trim()).filter(Boolean);
    return {
        number: parseInt(parts[0]),
        location: parts[1],
        timeReference: parts[2],
        units: parts[3],
        name: parts[4],
        trackName: parts[5]
    };
});

//Store original selection using SDK
let originalSelectionSamples = sf.app.proTools.getTimelineSelection({ timeScale: "Samples" })

//Ensure the user has actually made a selection within which we should operate
if (originalSelectionSamples.inTime === originalSelectionSamples.outTime)
    throw `Please make a selection before running this script`;

try {
    // Go to Selection Start
    sf.app.proTools.setTimelineSelection({
        inTime: originalSelectionSamples.inTime,
        outTime: originalSelectionSamples.inTime
    })

    // Filter Markers for the Marker Track Name, 
    // the location is after or equal to the in time 
    // the location is before or equal to the out time 
    let markersOnNamedTrack = markers.filter(
        marker =>
        (marker.trackName === markerTrackName
            && Number(marker.location) >= Number(originalSelectionSamples.inTime)
            && Number(marker.location) <= Number(originalSelectionSamples.outTime)
        )
    );

    // For each Marker On the Named Marker Track and Within our Selection, Split at the Marker
    markersOnNamedTrack.forEach((marker) => {
        // Go to the Markers Location 
        sf.app.proTools.setTimelineSelection({ inTime: marker.location });
        // Seperate the Clip
        sf.ui.proTools.menuClick({
            menuPath: ["Edit", "Separate Clip", "At Selection"],
            onError: 'Continue',
        });
    })

} finally {
    //Finally, regardless of any error occurring in the previous code,
    //restore the original selection
    sf.app.proTools.setTimelineSelection({
        inTime: originalSelectionSamples.inTime,
        outTime: originalSelectionSamples.outTime,
    });
}