Skip to main content

Get Track Ref

Category: Pr Tracks & Clips Get Track Ref block screenshot

Resolves a track by index or name. index is 0-based (0 = first track / V1 / A1). You can resolve the target either by zero-based index or by name. When multiple items share the same name, use duplicateIndex to pick which duplicate to return. Use kind to limit the block to VIDEO, AUDIO, or CAPTION items. If sequence is omitted, the block uses the active sequence when supported.

Inputs

InputRequiredValue KindTypesEnum Values
sequencenoexpressionreference, string, null
kindyesexpressionenum-stringVIDEO, AUDIO, CAPTION
indexnoexpressionnumber
namenoexpressionstring
duplicateIndexnoexpressionnumber

Notes

  • Resolves a track by index or name.
  • index is 0-based (0 = first track / V1 / A1).

See Also

  • Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.

Examples

Iterate Clips In V1

Resolves V1 and loops over all clip items on that track.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: track iteration, clip iteration

Source: patterns/ex-track-items-iterate-v1-clips.json

Download JSON

Apply One Audio Effect On An Isolated Sequence

Creates a fresh sequence from one source item, applies one audio effect to the first audio clip, and verifies that the component count increases by one.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: effects and component parameters, audio

Source: patterns/ex-audio-effect-apply-on-isolated-sequence.json

Download JSON

Apply One Video Effect On An Isolated Sequence

Creates a fresh sequence from one source item, applies one video effect to the first clip, and verifies that the component count increases by one.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: effects and component parameters, track item mutation

Source: patterns/ex-video-effect-apply-on-isolated-sequence.json

Download JSON