List Selected Track Items

Category: Pr Tracks & Clips

Reads the current timeline selection from the supplied sequence; when sequence is omitted, it uses the active sequence. Returns the same canonical ::ITEM\\CLIP#<index> reference family as prListTrackItems and prForEachTrackItem. It never returns legacy ::CLIP refs. trackKind defaults to ANY and currently accepts ANY, VIDEO, or AUDIO. kind defaults to ANY and currently accepts ANY or CLIP because Premiere's public selection API currently returns video/audio clip Track Items. ANY and CLIP therefore produce the same result today. The kind input is an explicit forward-compatibility placeholder for future Premiere selection item types, not an effective filter in current hosts. A Transition or Gap can still look selected in Premiere while being absent from this API. On Premiere 26.5 and Premiere 27.0 Beta, sole Cross Dissolve and Gap selections both returned an empty list; their track-scoped collections also supplied only null wrappers in the tested sequences. Do not infer that an empty result means Premiere shows no selected non-clip item. Output order is deterministic: timeline start, video before audio, Track index, then item ordinal. It does not claim Premiere click-selection order. The read does not add, remove, clear, or replace selected items. Returned ITEM refs are ordinal point-in-time paths. Their start/end snapshots are internal run-local guards and are not encoded in the string; they are cleared at transaction boundaries. A persisted ref string can bind the same ordinal to a replacement item in a later run. Relist after every structural timeline edit and never persist ITEM refs as durable identities. prGetTrackItemProperty(..., "TRACK_REF") returns the canonical owner Track ref and TRACK_KIND returns VIDEO or AUDIO after normal item resolution and any available run-local snapshot validation. Use kind to limit the block to ANY or CLIP items. If sequence is omitted, the block uses the active sequence when supported.

Inputs

Input	Required	Value Kind	Types	Enum Values
sequence	no	expression	reference, string	—
trackKind	no	expression	enum-string	ANY, VIDEO, AUDIO
kind	no	expression	enum-string	ANY, CLIP

Notes

• Reads the current timeline selection from the supplied sequence; when sequence is omitted, it uses the active sequence.
• Returns the same canonical ::ITEM\\CLIP#<index> reference family as prListTrackItems and prForEachTrackItem. It never returns legacy ::CLIP refs.
• trackKind defaults to ANY and currently accepts ANY, VIDEO, or AUDIO. kind defaults to ANY and currently accepts ANY or CLIP because Premiere's public selection API currently returns video/audio clip Track Items. ANY and CLIP therefore produce the same result today. The kind input is an explicit forward-compatibility placeholder for future Premiere selection item types, not an effective filter in current hosts.
• A Transition or Gap can still look selected in Premiere while being absent from this API. On Premiere 26.5 and Premiere 27.0 Beta, sole Cross Dissolve and Gap selections both returned an empty list; their track-scoped collections also supplied only null wrappers in the tested sequences. Do not infer that an empty result means Premiere shows no selected non-clip item.
• Output order is deterministic: timeline start, video before audio, Track index, then item ordinal. It does not claim Premiere click-selection order.
• The read does not add, remove, clear, or replace selected items. Returned ITEM refs are ordinal point-in-time paths. Their start/end snapshots are internal run-local guards and are not encoded in the string; they are cleared at transaction boundaries. A persisted ref string can bind the same ordinal to a replacement item in a later run. Relist after every structural timeline edit and never persist ITEM refs as durable identities.
• prGetTrackItemProperty(..., "TRACK_REF") returns the canonical owner Track ref and TRACK_KIND returns VIDEO or AUDIO after normal item resolution and any available run-local snapshot validation.

See Also

• Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.
• List Track Items: Returns the items on a track as a list.
• For Each Track Item: Iterates over the items of a track, with optional kind filter, time range, and order.
• Get Track Item Property: Reads the property selected in property from a track item.

Examples

List Selected Timeline Clips

Reads selected timeline clips as canonical Track Item references and reports their owner Track, kind, timing, and source name.

kind: Pattern · format: runtime-dsl · validation: Schema only

Topics: timeline inspection, selection, track items

Source: patterns/ex-timeline-items-list-selected.json

Download JSON