Tool

Parameters

What it does

ping

—

Check that Premiere is running and the bridge panel is alive.

get_timeline

detail, track_type, track_index, empty_tracks

Picture of the active sequence: resolution, frame rate, duration, and every clip on every track with its node ID, timing and Motion scale.

get_clip

node_id

Everything about one clip: timing, in-point, and every effect with all of its property values and keyframe state.

list_sequences

—

List every sequence in the project and say which one is active.

set_active_sequence

sequence

Make a sequence the active one, so every other tool operates on it.

create_sequence_from_items

name, item_ids

Create a new sequence built from one or more project items, and confirm it exists.

check_edit

max_scale, max_audio_db

Inspect the whole sequence and report the problems that quietly ruin an edit: clips scaled above 100 percent, stabilisers that were never analysed, audio above unity or with keyframes that spike, disabled clips, gaps on the main video track, muted tracks, and clips missing a grade while their neighbours have one.

critique_edit

platform

Judge the active sequence against what actually holds attention on a given platform, and say whether it is ready to post.

review_sequence

output_dir, frames, start_seconds, end_seconds

One pass over a whole sequence for judging it rather than editing it: writes evenly spaced stills across the running time, measures each one, and reports the sequence settings alongside them.

contact_sheet

output_dir, track_index, limit, isolate

Export one still per clip on a video track, taken from the middle of each clip, and return the file paths.

analyse_frame

time_seconds

Measure the image at a point in the sequence and suggest Basic Correction moves.

analyse_clips

track_index, limit

Measure one frame per clip on a video track and report the numbers side by side, so shots can be grouped by how they actually look rather than by eye.

read_scopes

time_seconds

Read the video scopes at a point in the sequence, the way a colourist would.

match_shots

reference_node_id, target_node_ids, apply, max_passes

Match one clip's grade to another by measurement rather than by eye.

get_playhead

—

Current playhead position in the active sequence, in seconds and as timecode.

set_playhead

time_seconds

Move the playhead to a time in seconds and read the position back.

get_sequence_range

—

Read the sequence in and out points and the work area, the two ranges that decide what a partial export covers.

set_sequence_range

in_seconds, out_seconds

Set the sequence in and out points, then read them back.

set_track_state

track_type, track_index, muted

Mute or unmute a video or audio track and read the state back.

list_markers

—

List every marker on the active sequence with its time, name and comment.

add_marker

time_seconds, name, comment, duration_seconds

Add a marker to the active sequence at a given time, then confirm it exists.

delete_marker

time_seconds, tolerance_seconds

Delete the marker nearest a given time, within a small tolerance, and report how many remain.

detect_beats

range, timeout_ms

Find the tempo of the sequence audio and return the beat grid, without changing anything.

mark_beats

grid, offset_seconds, limit, range, timeout_ms

Write sequence markers on the beat grid so the cuts can be placed by eye or by tool.

cut_to_beats

track_index, grid, offset_seconds, limit, range, timeout_ms

Razor a video track on the beat grid, so every cut lands on the music.

make_split_edit

cut_seconds, type, overlap_seconds, video_track, audio_track

Turn a straight cut into a J or L cut, the technique that most separates professional cutting from amateur.

find_action_peaks

node_id, samples

Measure movement across a clip and report where the action peaks, so a cut can land on the movement rather than near it.

check_delivery

samples, start_seconds, end_seconds

Run the quality control pass a broadcaster would run before accepting a file.

check_audio

range, timeout_ms

Render the mix and find the audio faults that ruin a delivery: passages clipped into distortion, stretches of dead silence, and a noise floor high enough to hear.

duck_music

music_track_index, dialogue_track_indexes, duck_db, attack_seconds, hold_seconds, release_seconds, on_existing_keyframes, dry_run, timeout_ms

Pull a music bed down under the talking and let it back up in the gaps, the way a mixer rides a fader, instead of leaving one flat level for the whole timeline.

clean_dialogue

track_index, high_pass_hz, ratio, threshold_db, attack_ms, release_ms, compress, dry_run, timeout_ms

Put the standard dialogue chain on a voice track and prove it did something: a high pass to kill rumble, then compression to even out the level.

list_project_items

limit

List the project panel contents: bins and media, with the node ID of each.

import_media

file_paths, bin_name

Import one or more media files into the project panel and confirm the item count grew.

create_bin

name

Create a bin in the project panel and confirm it exists.

check_media

limit

Report the link state of every media item: whether it is offline, where its media actually lives on disk, and whether a proxy is attached.

attach_proxy

item_id, proxy_path

Attach a proxy file to a project item, so Premiere edits against the light version while keeping the original for export.

relink_media

item_id, new_path

Point an offline project item at its file in a new location and confirm it came back online.

set_clip_enabled

node_id, enabled

Enable or disable a clip.

split_clip

track_type, track_index, time_seconds

Cut every clip on a track at the given time, the same as the razor tool.

remove_clip

node_id, ripple

Remove a clip from the timeline.

add_to_timeline

item_id, track_type, track_index, time_seconds, mode

Place a project item onto a track at a given time and confirm the clip count grew.

move_clip

node_id, time_seconds, overwrite

Move a clip to a new start time on its own track and confirm it landed.

set_clip_speed

node_id, speed_percent

Change a clip's playback speed.

trim_clip

node_id, edge, time_seconds

Trim a clip's start or end on the timeline and confirm the new duration.

set_scale

node_id, scale

Set a clip's Motion scale and read it back to confirm.

grade_clips

node_ids, add_lumetri_if_missing, exposure, contrast, highlights, shadows, whites, blacks, saturation, temperature, tint, look_intensity

Apply the same Lumetri Basic Correction to a group of clips in one pass, then read every value back.

set_lumetri

node_id, exposure, contrast, highlights, shadows, whites, blacks, saturation, temperature, tint, look_intensity

Set Lumetri Basic Correction values on a clip and read them back.

match_grade

source_node_id, target_node_ids

Copy one clip's Lumetri Basic Correction onto other clips as a starting point, then read every value back.

get_grade

—

Read the Lumetri Basic Correction values of every graded clip in one call, so a grade can be compared across shots without inspecting clips one at a time.

set_audio_level

node_id, db

Set a clip's audio level in decibels and read it back.

normalise_loudness

target, track_index, range, allow_clipping, timeout_ms

Measure the sequence loudness and then actually move the audio to hit the target, in one pass.

analyse_loudness

target, range, timeout_ms

Measure how loud the sequence actually is, in LUFS to ITU-R BS.1770, by rendering its audio to a temporary WAV and analysing it here.

set_fade

node_id, fade_in_seconds, fade_out_seconds

Put a clean fade in and/or out on a clip: Opacity for video, Volume for audio.

list_effects

kind, filter

List every video or audio effect name Premiere can apply.

apply_effect

node_id, effect_name

Add a video or audio effect to a clip by name and confirm it attached.

list_transitions

filter

List every video transition name Premiere can apply, for use with add_transition.

add_transition

node_id, transition_name, at

Add a video transition at a clip's head or tail and confirm it appeared on the track.

get_stabilizer_status

—

Report Warp Stabilizer state for every clip that has it.

set_stabilizer_mode

node_id, mode, max_scale

Set Warp Stabilizer to 'no_motion' (locked static frame, what static-camera edits need) or 'smooth_motion' (keeps camera movement, smoothed).

export_frame

output_path, time_seconds

Write a full resolution still of the sequence at a given time.

list_export_presets

filter, limit

List Adobe .epr export presets on disk, including the ones Premiere ships itself.

export_sequence

output_path, preset_path, range, timeout_ms

Render the active sequence to a file using Premiere's own encoder; Adobe Media Encoder is not required.

save_project

—

Save the current project.

run_script

code, timeout_ms

Escape hatch: run raw ExtendScript in Premiere for anything the typed tools do not cover.