Set Source Monitor Position
Seek the currently open source in source-relative seconds (Premiere 26.3+). Fractional seconds are converted to the nearest Premiere tick to preserve exact frame boundaries; no whole-second rounding, frame-rate arithmetic, or embedded timecode offset is applied. An empty Source Monitor, unavailable API, or invalid time follows onError. Native out-of-range behavior remains Premiere-owned. Neither command starts playback. 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 |
|---|---|---|---|---|
positionSeconds | yes | expression | number | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | variable-name | — |
Notes
Seeks the current Source Monitor project item using finite non-negative, fractional positionSeconds. Requires Premiere 26.3+. Fractional seconds are rounded only to the nearest Premiere tick to avoid landing one tick before an exact frame boundary. Use source-relative time, not sequence time or displayed source timecode. Does not start playback. Use onError: "RETURN_FALSE" for optional preview and check successful opening before seeking; neither an unavailable API nor failed opening should block an individual transcript review.
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