List Project Items
Returns project items from a bin or the current Project Panel selection, optionally expanding selected bins recursively. With onlySelected=false, bin/includeSubbins define normal bin traversal. With onlySelected=true, selected Project Panel items are traversal roots; BIN_AND_SUBBINS recursively expands selected bins even when TYPE_BIN is not requested, then types filters returned items. Selected bins themselves require TYPE_BIN. Overlapping roots are deduplicated at first occurrence. An explicit bin scopes selected roots to that subtree; omitting bin uses the whole selection. Order preserves Premiere selection-API order followed by depth-first folder-item API order, not an alphabetical/UI-sort guarantee. Use includeSubbins to search only the current bin or also its children, for example BIN_ONLY or BIN_AND_SUBBINS. Use types to filter by item kinds such as TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, or TYPE_FILE. Set onlySelected to return only currently selected project items.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
bin | no | expression | reference, string, null | — |
includeSubbins | no | expression | enum-string, boolean | BIN_ONLY, BIN_AND_SUBBINS |
onlySelected | no | expression | boolean | — |
types | no | array | enum-string | TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, TYPE_FILE |
Notes
No additional notes are available yet.
See Also
- Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.
Examples
Create Empty Sequence Matching Selected Item And Place It
Creates an empty sequence whose settings match the first selected project item, stores the returned sequence ref, then places the item explicitly into that sequence.
Topics: sequence creation, project inspection, timeline placement, matched sequence settings
Source: patterns/ex-sequence-create-matching-item-and-place.json
Create Sequence From Selected Item And Place Into It
Creates a sequence from the first selected project item, then uses the stored sequence ref for a follow-up placement.
Topics: sequence creation, project inspection, timeline placement
Source: patterns/ex-sequence-create-from-selected-and-place.json
List Selected Project Items
Minimal pattern for reading selected project items and counting them.
Topics: project inspection, selection
Source: patterns/ex-project-items-list-selected.json