Get selected Clip Name

It works like a charm!
Thanks a lot!

Hey @Brian_Mullany, nowadays I would opt for a different approach for this.

• Updated May 3rd, 2025—Ensures "Link Track and Edit Selection" and "Link Timeline and Edit Selection" are engaged while fetching clips. Ensures only Audio tracks are selected (only audio clips can be fetched).
• Updated Feb 4th, 2025 — Fades are now removed by default (Thanks Chris Shaw!)

/** Ensures a menu item is menu checked (or not) while an action takes place.
 * @param {{ 
 * menuItemPath: [string, string, string?, string?, string?, string?], 
 * doWithout?: boolean, // Ensures the menu item is NOT menu checked
 * callback: function
 * }} args */
function doWithMenuItemToggle({ menuItemPath, doWithout = false, callback }) {
    const menuItem = sf.ui.proTools.getMenuItem(...menuItemPath);
    const isMenuItemChecked = menuItem.isMenuChecked;

    if (!isMenuItemChecked && !doWithout || isMenuItemChecked && doWithout) {
        menuItem.elementClick();
    }

    const result = callback();

    if (!isMenuItemChecked && !doWithout || isMenuItemChecked && doWithout) {
        menuItem.elementClick();
    }

    return { result };
}

/** @param {{ includeFades?: boolean }} [args] */
function getSelectedClipInfo({ includeFades = false } = {}) {
    /** @typedef{{ clipName: string, trackName: string, startTime: number, endTime: number }[]} clips */

    function main() {
        const selectionInTime = Number(
            sf.app.proTools.getTimelineSelection().inTime
        );
        const selectionOutTime = Number(
            sf.app.proTools.getTimelineSelection().outTime
        );

        const tracks = sf.app.proTools.tracks.invalidate().allItems;

        // Deselect non-Audio tracks
        sf.app.proTools.selectTracksByName({
            selectionMode: "Subtract",
            trackNames: tracks
                .filter(track => track.type !== "Audio")
                .map(track => track.name)
        });

        /** @type{clips} */
        const fullySelectedClips = sf.app.proTools.getSelectedClipInfo().clips
            .reduce((clips, clip) => {
                if (!includeFades) {
                    if (clip.clipName.startsWith("(fade") || clip.clipName === "(cross fade)") {
                        return clips;
                    }
                }

                const clipStartTime = Number(clip.startTime);
                const clipEndTime = Number(clip.endTime) - 1;

                const isClipFullySelected = clipStartTime >= selectionInTime
                    && clipEndTime < selectionOutTime;

                if (isClipFullySelected) {
                    // Remove any extensions from clipName (.L, .R...)
                    const clipName = clip.clipName.replace(/\.\w+$/, "");

                    // Filter repeated clips
                    if (clips.some(clip => clip.clipName === clipName)) return clips;

                    clips.push({
                        clipName,
                        trackName: clip.trackName,
                        startTime: clipStartTime,
                        endTime: clipEndTime
                    });
                }
                return clips;
            }, []);


        const names = fullySelectedClips.map(clip => clip.clipName);

        return { clips: fullySelectedClips, names };
    }

    /** @type {{ clips: clips, names: string[] }} */
    const result = doWithMenuItemToggle({
        menuItemPath: ["Options", "Link Track and Edit Selection"],
        callback: () =>
            doWithMenuItemToggle({
                menuItemPath: ["Options", "Link Timeline and Edit Selection"],
                callback: main
            }).result,
    }).result;

    return result;
}

const selectedClipNames = getSelectedClipInfo().names;

log(selectedClipNames);

This script does the following:

• Gets clip info through the PT SDK, which is more robust than scraping the UI.
• Fixes an issue with the original SDK command where adjacent clips would be listed as selected.
• Removes multichannel duplicates (i.e. stereo files would be listed as two different files).

Hey @Brian_Mullany, I just updated my script above incorporating Chris' method of removing fades, that now allows us to easily get the first selected clip name like so:

const selectedClipNames = getSelectedClipInfo().names;
const firstSelectedClipName = selectedClipNames[0];