Open Project Item in Source Monitor
Open a project item in the Source Monitor (Premiere 25.6+). Sequence references resolve to their project item; unsupported items are rejected by Premiere. After native opening succeeds, wait up to five seconds for the requested item to become current; timeout follows onError. Opening and seeking are separate composable commands because they have different version requirements and independent uses. Gate seeking on successful opening when previewing a specific clip. Both commands commit pending grouped Actions before host permission/reference resolution. They do not start playback or create an undoable edit. storeResultIn resets to false before evaluation and receives the native boolean. onError defaults to STOP; CONTINUE and RETURN_FALSE leave false on exceptions, including unavailable APIs. Native false is returned as false, matching existing Premiere action blocks. Requires Premiere WRITE permission for the affected project item.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
item | yes | expression | reference, string | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | variable-name | — |
Notes
Use two composable commands: opening works on 25.6+, seeking requires 26.3+. Opening alone and repeated seeking of the current source remain useful independently. prSourceMonitorOpenProjectItem accepts item; prSourceMonitorSetPosition accepts finite non-negative positionSeconds in source-relative seconds. Preserve fractional precision; do not parse a display timecode. Resolve project refs freshly after pending Actions commit and immediately before native opening. Opening returns true only after the requested item is visible to the native Source Monitor getter (up to five seconds); a timeout follows onError. Gate seeking on the opening result. Both commands commit pending grouped Actions before host permission/reference resolution. They do not start playback or create an undoable edit. storeResultIn resets to false before evaluation and receives the native boolean. onError defaults to STOP; CONTINUE and RETURN_FALSE leave false on exceptions, including unavailable APIs. Native false is returned as false, matching existing Premiere action blocks. Requires Premiere WRITE permission for the affected project item.
Proofread Transcripts calls these only directly before an individual decision dialog. Its original word-span start is used only when unambiguous, otherwise the original segment start, with one second of preroll clamped to zero. Missing timing skips seeking. Preview failure never prevents review; automatically handled suggestions do not open or seek.
Examples
Preview a Project Clip in Source Monitor
Open a source and seek to fractional source time without starting playback; optional preview failures continue.
Topics: source monitor, preview
Source: patterns/ex-source-monitor-preview.json