@synthetic-ai/premiere-mcp 2.3.1 → 2.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,1488 @@
1
+ {
2
+ "msg.bridge.blockedPattern": "Script contains blocked pattern: {pattern}",
3
+ "msg.bridge.parseFailed": "Failed to parse response: {error}",
4
+ "msg.bridge.scriptTooLarge": "Script exceeds {limit} size limit",
5
+ "msg.bridge.timeout": "Command timed out after {ms}ms. Is the CEP plugin running in Premiere Pro?",
6
+ "msg.doctor.allGood": "Everything looks good.",
7
+ "msg.doctor.language": "Language: {language}",
8
+ "msg.doctor.languageDefault": "Default. Change it with PREMIERE_PRO_MCP_LANG or in the panel Settings (⚙).",
9
+ "msg.doctor.languageFrom": "Chosen from {source}",
10
+ "msg.doctor.licenseExpires": "Expires: {date}",
11
+ "msg.doctor.licenseInvalid": "License validation failed",
12
+ "msg.doctor.licenseMissing": "PREMIERE_PRO_MCP_LICENSE not set",
13
+ "msg.doctor.licenseMissingDetail": "Add it to your MCP client config (claude_desktop_config.json or equivalent).",
14
+ "msg.doctor.licenseNoExpiration": "No expiration",
15
+ "msg.doctor.licensePresent": "License key present ({prefix}...)",
16
+ "msg.doctor.licenseValid": "License validates",
17
+ "msg.doctor.nodeTooOld": "Requires Node 18 or newer — update from nodejs.org",
18
+ "msg.doctor.os": "OS: {os}",
19
+ "msg.doctor.premiereFound": "Premiere Pro detected",
20
+ "msg.doctor.premiereNotFound": "Premiere Pro not found in the usual install location",
21
+ "msg.doctor.premiereNotFoundDetail": "Not fatal — the MCP server only needs Premiere Pro running when a tool actually calls it.",
22
+ "msg.doctor.someFailed": "Some checks failed.",
23
+ "msg.doctor.someFailedHint": "Fix the items above, or share this output with support at https://synthetic.com.ar/dashboard/support",
24
+ "msg.doctor.tempNotWritable": "Bridge temp directory not writable",
25
+ "msg.doctor.tempWritable": "Bridge temp directory writable",
26
+ "msg.doctor.title": "premiere-mcp doctor — checking your setup",
27
+ "msg.doctor.unknownReason": "Unknown reason",
28
+ "msg.help.doctor": "Check your setup (Node, license, Premiere Pro, temp dir)",
29
+ "msg.help.env": "Environment variables:",
30
+ "msg.help.envLang": "Language of tool descriptions and messages: {languages} (default: the panel setting, else English)",
31
+ "msg.help.envTempDir": "Shared temp directory (default: OS temp + /premiere-mcp-bridge)",
32
+ "msg.help.envTimeout": "Command timeout in ms (default: 30000)",
33
+ "msg.help.help": "Show this help message",
34
+ "msg.help.installCep": "Install the CEP plugin into Premiere Pro",
35
+ "msg.help.moreInfo": "More info: {url}",
36
+ "msg.help.start": "Start the MCP server (stdio transport)",
37
+ "msg.help.title": "MCP server for Adobe Premiere Pro ({count} tools)",
38
+ "msg.help.usage": "Usage:",
39
+ "msg.help.version": "Show version",
40
+ "msg.installCep.failed": "CEP installation failed. Try running manually:",
41
+ "msg.installCep.installing": "Installing CEP plugin...",
42
+ "msg.license.getLicense": "Get a license at https://synthetic.com.ar/premiere-mcp",
43
+ "msg.license.invalid": "Invalid or missing license.",
44
+ "msg.license.missing": "No license key. Set PREMIERE_PRO_MCP_LICENSE in your MCP config. Get a license at https://synthetic.com.ar/premiere-mcp",
45
+ "msg.license.required": "License required",
46
+ "msg.license.unreachable": "License server unreachable. Check your internet connection.",
47
+ "msg.resource.extendscriptReference": "Complete Premiere Pro ExtendScript API reference for writing custom scripts via execute_extendscript",
48
+ "msg.resource.instructions": "Instructions and best practices for using Premiere Pro via MCP tools",
49
+ "msg.tool.audioEffectsNote": "Static list of common Premiere Pro audio effects. Use apply_audio_effect with these exact names.",
50
+ "msg.tool.audioTransitionsNote": "Premiere Pro has 3 audio transitions. 'Constant Power' is the recommended default for music crossfades.",
51
+ "msg.tool.error": "Error: {message}",
52
+ "msg.tool.frameCaptured": "Frame captured successfully.",
53
+ "msg.tool.frameNotFound": "Frame export completed but file not found at: {path}",
54
+ "msg.tool.frameReadFailed": "Failed to read captured frame: {error}",
55
+ "msg.tool.videoEffectsNote": "Static list of common Premiere Pro video effects. Use apply_effect with these exact names.",
56
+ "msg.tool.videoTransitionsNote": "Static list of common Premiere Pro video transitions. Use add_transition with these exact names.",
57
+ "tool.add_adjustment_layer": "Add an adjustment layer to the active sequence via QE DOM. The layer is added at the playhead position on the specified track.",
58
+ "tool.add_adjustment_layer.param.track_index": "Video track index (default: 0)",
59
+ "tool.add_audio_keyframes": "Add audio level keyframes to create fades or level changes",
60
+ "tool.add_audio_keyframes.param.keyframes": "Array of keyframe objects with time_seconds and level_db",
61
+ "tool.add_audio_keyframes.param.node_id": "Node ID of the clip",
62
+ "tool.add_audio_track": "Add a new audio track to the active sequence.\n\nPreconditions: An active sequence must exist.\n\nTrack types:\n- \"standard\" (default): Standard stereo audio track — works with most clips.\n- \"5.1\": 5.1 surround audio track.\n- \"adaptive\": Adaptive audio track (multi-channel routing).\n- \"mono\": Mono audio track.\n\nThe new track is added at the bottom of the audio tracks (highest index). Its index can be found via list_sequence_tracks after creation.\n\nExample: add_audio_track({}) — adds a standard stereo track\nExample: add_audio_track({ track_type: \"mono\", name: \"Narration\" })",
63
+ "tool.add_audio_track.param.name": "Optional name to set on the track after creation",
64
+ "tool.add_audio_track.param.track_type": "Audio track type (default: standard stereo)",
65
+ "tool.add_custom_metadata_field": "Add a custom metadata field to the project's metadata schema",
66
+ "tool.add_custom_metadata_field.param.field_label": "Display label for the field",
67
+ "tool.add_custom_metadata_field.param.field_name": "Internal name for the metadata field",
68
+ "tool.add_custom_metadata_field.param.field_type": "Type of the field: 0 = Integer, 1 = Real, 2 = String, 3 = Boolean",
69
+ "tool.add_keyframe": "Add a keyframe to an effect property at a specific time",
70
+ "tool.add_keyframe.param.effect_name": "Display name of the effect",
71
+ "tool.add_keyframe.param.node_id": "Node ID of the clip",
72
+ "tool.add_keyframe.param.property_name": "Display name of the property",
73
+ "tool.add_keyframe.param.time_seconds": "Time in seconds relative to clip start where to add keyframe",
74
+ "tool.add_keyframe.param.value": "Value at the keyframe",
75
+ "tool.add_marker": "Add a marker to the active sequence or a clip",
76
+ "tool.add_marker.param.color": "Marker color index (0=Green, 1=Red, 2=Purple, 3=Orange, 4=Yellow, 5=White, 6=Blue, 7=Cyan)",
77
+ "tool.add_marker.param.comments": "Comments for the marker",
78
+ "tool.add_marker.param.duration_seconds": "Duration of the marker in seconds (0 for point marker)",
79
+ "tool.add_marker.param.name": "Name/label for the marker",
80
+ "tool.add_marker.param.node_id": "Optional clip node ID to add marker to clip instead of sequence",
81
+ "tool.add_marker.param.time_seconds": "Time position in seconds for the marker",
82
+ "tool.add_marker_to_project_item": "Add a marker to a project item (source clip marker).",
83
+ "tool.add_marker_to_project_item.param.color_index": "Color label index (0-7)",
84
+ "tool.add_marker_to_project_item.param.comments": "Marker comments",
85
+ "tool.add_marker_to_project_item.param.duration_seconds": "Duration of the marker in seconds (0 for point marker)",
86
+ "tool.add_marker_to_project_item.param.item_id": "Node ID or name of the project item",
87
+ "tool.add_marker_to_project_item.param.name": "Marker name",
88
+ "tool.add_marker_to_project_item.param.time_seconds": "Time in seconds for the marker",
89
+ "tool.add_marker_to_project_item.param.type": "Marker type (default: Comment)",
90
+ "tool.add_panning_keyframe": "Add a panning keyframe to an audio clip at a specific time. Enables time-varying stereo panning automation.",
91
+ "tool.add_panning_keyframe.param.clip_index": "Clip index on the track (0-based)",
92
+ "tool.add_panning_keyframe.param.pan_value": "Pan value from -100 (full left) to +100 (full right)",
93
+ "tool.add_panning_keyframe.param.time": "Time in seconds (relative to sequence start)",
94
+ "tool.add_panning_keyframe.param.track_index": "Audio track index (0-based)",
95
+ "tool.add_text_overlay": "Add a text overlay (title) to the active sequence",
96
+ "tool.add_text_overlay.param.duration_seconds": "Duration in seconds (default: 5)",
97
+ "tool.add_text_overlay.param.font_size": "Font size (default: 60)",
98
+ "tool.add_text_overlay.param.start_seconds": "Start time in seconds (default: 0)",
99
+ "tool.add_text_overlay.param.text": "Text content to display",
100
+ "tool.add_text_overlay.param.track_index": "Video track index to place the text on (default: topmost track)",
101
+ "tool.add_to_render_queue": "Add the active sequence to the Adobe Media Encoder render queue",
102
+ "tool.add_to_render_queue.param.output_path": "Full output file path",
103
+ "tool.add_to_render_queue.param.preset_path": "Path to an AME preset file (.epr)",
104
+ "tool.add_to_timeline": "Add a project item (clip, image, or audio file) to the active sequence timeline at a specific position.\n\nPreconditions: An active sequence must exist (use create_sequence or set_active_sequence first). The item must already be imported into the project (use import_media first).\n\nThe clip is inserted using insert-edit semantics — content after the insertion point shifts forward. For overwrite-edit behavior, use overwrite_clip instead.\n\nParameters:\n- item_id: The node ID from list_project_items, or the item's display name (partial match supported).\n- track_index: Video track index (0 = V1, 1 = V2, etc.). Higher tracks composite on top.\n- start_seconds: Timeline position in seconds where the clip should start (e.g., 10.5 = 10 seconds 12 frames at 24fps).\n- audio_track_index: Audio track index for the linked audio (default matches track_index).\n\nExample: add_to_timeline({ item_id: \"interview.mp4\", track_index: 0, start_seconds: 30, audio_track_index: 0 })",
105
+ "tool.add_to_timeline.param.audio_track_index": "Audio track index for the audio portion (default: 0)",
106
+ "tool.add_to_timeline.param.item_id": "Node ID or name of the project item to add",
107
+ "tool.add_to_timeline.param.start_seconds": "Start time in seconds on the timeline (default: 0)",
108
+ "tool.add_to_timeline.param.track_index": "Video track index (0-based, default: 0)",
109
+ "tool.add_track": "Add a new video or audio track to the active sequence",
110
+ "tool.add_track.param.count": "Number of tracks to add (default: 1)",
111
+ "tool.add_track.param.track_type": "Type of track to add",
112
+ "tool.add_tracks": "Add video and/or audio tracks to the active sequence. Uses QE DOM.",
113
+ "tool.add_tracks.param.audio_51_tracks": "Number of 5.1 audio tracks to add (default: 0)",
114
+ "tool.add_tracks.param.audio_mono_tracks": "Number of mono audio tracks to add (default: 0)",
115
+ "tool.add_tracks.param.audio_tracks": "Number of standard stereo audio tracks to add (default: 0)",
116
+ "tool.add_tracks.param.video_tracks": "Number of video tracks to add (default: 0)",
117
+ "tool.add_transition": "Add a video transition between two clips at a cut point. Uses QE DOM.",
118
+ "tool.add_transition.param.cut_point_seconds": "Time position in seconds of the cut point where the transition should be placed",
119
+ "tool.add_transition.param.duration_seconds": "Duration of the transition in seconds (default: 1.0)",
120
+ "tool.add_transition.param.track_index": "Video track index (0-based)",
121
+ "tool.add_transition.param.transition_name": "Name of the transition (e.g., 'Cross Dissolve', 'Dip to Black')",
122
+ "tool.add_transition_to_clip": "Add a transition to a specific clip's start or end",
123
+ "tool.add_transition_to_clip.param.duration_seconds": "Duration of the transition in seconds (default: 1.0)",
124
+ "tool.add_transition_to_clip.param.node_id": "Node ID of the clip",
125
+ "tool.add_transition_to_clip.param.position": "Where to apply the transition (default: end)",
126
+ "tool.add_transition_to_clip.param.transition_name": "Name of the transition",
127
+ "tool.add_volume_keyframe": "Add a volume keyframe to an audio clip at a specific time. Enables time-varying volume automation.",
128
+ "tool.add_volume_keyframe.param.clip_index": "Clip index on the track (0-based)",
129
+ "tool.add_volume_keyframe.param.level_db": "Volume level in dB at this keyframe. Range: -96 to +15.",
130
+ "tool.add_volume_keyframe.param.time": "Time in seconds (relative to sequence start)",
131
+ "tool.add_volume_keyframe.param.track_index": "Audio track index (0-based)",
132
+ "tool.adjust_audio_levels": "Adjust the audio level (volume) of a clip in dB",
133
+ "tool.adjust_audio_levels.param.level_db": "Audio level in dB (0 = unity, negative = quieter, positive = louder)",
134
+ "tool.adjust_audio_levels.param.node_id": "Node ID of the audio or video clip",
135
+ "tool.apply_audio_effect": "Apply any audio effect to a clip by exact name using the QE DOM.",
136
+ "tool.apply_audio_effect.param.clip_index": "Clip index on the track (0-based)",
137
+ "tool.apply_audio_effect.param.effect_name": "Exact name of the audio effect to apply (e.g. 'Reverb', 'Chorus/Flanger', 'Pitch Shifter')",
138
+ "tool.apply_audio_effect.param.track_index": "Audio track index (0-based)",
139
+ "tool.apply_audio_noise_reduction": "Apply DeNoise audio effect to reduce background noise in a clip.",
140
+ "tool.apply_audio_noise_reduction.param.amount": "Noise reduction amount 0-100. Default: 50.",
141
+ "tool.apply_audio_noise_reduction.param.clip_index": "Clip index on the track (0-based)",
142
+ "tool.apply_audio_noise_reduction.param.track_index": "Audio track index (0-based)",
143
+ "tool.apply_audio_preset": "Apply a named audio effect preset to a clip. Use get_audio_effect_presets to see available presets.",
144
+ "tool.apply_audio_preset.param.clip_index": "Clip index on the track (0-based)",
145
+ "tool.apply_audio_preset.param.preset_name": "Name of the audio effect (e.g. 'Parametric Equalizer', 'Dynamics', 'Hard Limiter', 'DeEsser', 'DeHummer', 'DeNoise', 'Reverb')",
146
+ "tool.apply_audio_preset.param.track_index": "Audio track index (0-based)",
147
+ "tool.apply_color_grade_to_all": "Copy a color grade from one clip and apply it to all clips on a specified track.",
148
+ "tool.apply_color_grade_to_all.param.dest_track_index": "Destination track index where all clips will receive the grade",
149
+ "tool.apply_color_grade_to_all.param.src_clip_index": "Source clip index (0-based)",
150
+ "tool.apply_color_grade_to_all.param.src_track_index": "Source clip video track index (0-based)",
151
+ "tool.apply_compressor": "Apply a Dynamics/Compressor audio effect to a clip. Controls threshold, ratio, attack, and release.",
152
+ "tool.apply_compressor.param.attack": "Attack time in milliseconds. Default: 10.",
153
+ "tool.apply_compressor.param.clip_index": "Clip index on the track (0-based)",
154
+ "tool.apply_compressor.param.ratio": "Compression ratio (e.g. 4 means 4:1). Default: 4.",
155
+ "tool.apply_compressor.param.release": "Release time in milliseconds. Default: 100.",
156
+ "tool.apply_compressor.param.threshold": "Threshold in dB where compression starts (e.g. -20). Default: -20.",
157
+ "tool.apply_compressor.param.track_index": "Audio track index (0-based)",
158
+ "tool.apply_corner_pin": "Apply Corner Pin effect to distort a clip by moving its four corners. Useful for screen replacements.",
159
+ "tool.apply_corner_pin.param.clip_index": "Clip index on the track (0-based)",
160
+ "tool.apply_corner_pin.param.corners": "Array of 4 corner points as fractions: [{x,y},{x,y},{x,y},{x,y}] in order: upper-left, upper-right, lower-right, lower-left.",
161
+ "tool.apply_corner_pin.param.track_index": "Video track index (0-based)",
162
+ "tool.apply_de_esser": "Apply a DeEsser audio effect to reduce sibilant 's' and 'sh' sounds in speech. Targets a specific frequency.",
163
+ "tool.apply_de_esser.param.clip_index": "Clip index on the track (0-based)",
164
+ "tool.apply_de_esser.param.frequency": "Target frequency in Hz (typically 6000-8000 for sibilance). Default: 6000.",
165
+ "tool.apply_de_esser.param.reduction": "Reduction amount in dB (negative value, e.g. -10). Default: -10.",
166
+ "tool.apply_de_esser.param.track_index": "Audio track index (0-based)",
167
+ "tool.apply_de_hum": "Apply DeHum audio effect to remove electrical hum (50Hz or 60Hz) from a clip.",
168
+ "tool.apply_de_hum.param.clip_index": "Clip index on the track (0-based)",
169
+ "tool.apply_de_hum.param.frequency": "Hum frequency in Hz. Use 50 (Europe) or 60 (Americas). Default: 60.",
170
+ "tool.apply_de_hum.param.track_index": "Audio track index (0-based)",
171
+ "tool.apply_de_reverb": "Apply DeReverb audio effect to reduce room reverb/echo in a clip.",
172
+ "tool.apply_de_reverb.param.amount": "Reverb reduction amount 0-100. Default: 50.",
173
+ "tool.apply_de_reverb.param.clip_index": "Clip index on the track (0-based)",
174
+ "tool.apply_de_reverb.param.track_index": "Audio track index (0-based)",
175
+ "tool.apply_directional_blur": "Apply Directional Blur video effect to a clip for a motion blur look.",
176
+ "tool.apply_directional_blur.param.clip_index": "Clip index on the track (0-based)",
177
+ "tool.apply_directional_blur.param.direction": "Blur direction angle in degrees. Default: 0 (horizontal).",
178
+ "tool.apply_directional_blur.param.length": "Blur length in pixels. Default: 10.",
179
+ "tool.apply_directional_blur.param.track_index": "Video track index (0-based)",
180
+ "tool.apply_effect": "Apply a video effect to a clip by name. Uses QE DOM for effect lookup.\n\nPreconditions: Active sequence required. The clip must exist on the timeline. Use list_available_effects to find exact effect names before calling this tool.\n\nCommon effect names: \"Gaussian Blur\", \"Lumetri Color\", \"Warp Stabilizer\", \"Unsharp Mask\", \"Fast Color Corrector\", \"Brightness & Contrast\", \"Hue/Saturation\", \"Sharpen\", \"Video Limiter\", \"Timecode\".\n\nAfter applying, use get_effect_properties to see the effect's parameters, then set_effect_property or add_keyframe to adjust values.\n\nExample: apply_effect({ node_id: \"abc123\", effect_name: \"Gaussian Blur\" })\nExample: apply_effect({ node_id: \"abc123\", effect_name: \"Lumetri Color\" })",
181
+ "tool.apply_effect.param.effect_name": "Name of the effect (e.g., 'Gaussian Blur', 'Lumetri Color')",
182
+ "tool.apply_effect.param.node_id": "Node ID of the clip to apply the effect to",
183
+ "tool.apply_effect_to_multiple_clips": "Apply the same video effect to multiple clips on a track using QE DOM.",
184
+ "tool.apply_effect_to_multiple_clips.param.clip_indices": "Array of clip indices to apply the effect to",
185
+ "tool.apply_effect_to_multiple_clips.param.effect_name": "Name of the effect to apply (e.g. 'Gaussian Blur', 'Lumetri Color')",
186
+ "tool.apply_effect_to_multiple_clips.param.track_index": "Track index (0-based)",
187
+ "tool.apply_effect_to_multiple_clips.param.track_type": "Track type: 'video' or 'audio'",
188
+ "tool.apply_eq": "Apply Parametric Equalizer effect to an audio clip. Optionally specify EQ bands as JSON array with freq, gain, and q values.",
189
+ "tool.apply_eq.param.bands": "Optional EQ bands as array of {freq, gain, q} objects. Example: [{freq:1000, gain:-6, q:1.0}]",
190
+ "tool.apply_eq.param.clip_index": "Clip index on the track (0-based)",
191
+ "tool.apply_eq.param.track_index": "Audio track index (0-based)",
192
+ "tool.apply_gaussian_blur": "Apply Gaussian Blur video effect to a clip.",
193
+ "tool.apply_gaussian_blur.param.blurriness": "Blur amount. Default: 10. Higher values = more blur.",
194
+ "tool.apply_gaussian_blur.param.clip_index": "Clip index on the track (0-based)",
195
+ "tool.apply_gaussian_blur.param.track_index": "Video track index (0-based)",
196
+ "tool.apply_lens_distortion_removal": "Apply Lens Distortion effect to correct barrel/pincushion lens distortion.",
197
+ "tool.apply_lens_distortion_removal.param.clip_index": "Clip index on the track (0-based)",
198
+ "tool.apply_lens_distortion_removal.param.curvature": "Curvature correction. Negative = correct barrel distortion. Default: -50.",
199
+ "tool.apply_lens_distortion_removal.param.track_index": "Video track index (0-based)",
200
+ "tool.apply_limiter": "Apply a Hard Limiter audio effect to a clip to prevent clipping. Sets a ceiling level in dB.",
201
+ "tool.apply_limiter.param.ceiling": "Maximum output level in dB (e.g. -0.1 to prevent clipping). Default: -0.1.",
202
+ "tool.apply_limiter.param.clip_index": "Clip index on the track (0-based)",
203
+ "tool.apply_limiter.param.track_index": "Audio track index (0-based)",
204
+ "tool.apply_lut": "Apply a LUT (Look-Up Table) file to a clip via Lumetri Color's Creative or Input LUT slot.\n\nPreconditions: Active sequence required. The LUT file must be accessible on disk at the specified path. Lumetri Color effect is automatically applied to the clip if not already present.\n\nSupported LUT formats: .cube, .look, .lut, .3dl, .mga.\n\nParameters:\n- node_id: Clip to apply the LUT to.\n- lut_path: Absolute path to the LUT file (e.g., \"C:\\LUTs\\rec709.cube\" or \"/Users/you/LUTs/film.cube\").\n- lut_strength: Intensity of the LUT effect (0.0 = no effect, 1.0 = full strength, default: 1.0).\n\nExample: apply_lut({ node_id: \"abc123\", lut_path: \"/Users/you/LUTs/orange-teal.cube\", lut_strength: 0.8 })",
205
+ "tool.apply_lut.param.lut_path": "Full path to the .cube or .3dl LUT file",
206
+ "tool.apply_lut.param.node_id": "Node ID of the clip",
207
+ "tool.apply_lut_to_all_clips": "Apply a LUT file to all clips on a video track via Lumetri Color.",
208
+ "tool.apply_lut_to_all_clips.param.lut_path": "Full path to the LUT file (.cube or .3dl)",
209
+ "tool.apply_lut_to_all_clips.param.track_index": "Video track index (0-based)",
210
+ "tool.apply_mirror": "Apply Mirror video effect to a clip to create a reflection.",
211
+ "tool.apply_mirror.param.angle": "Reflection angle in degrees. Default: 0 (horizontal mirror).",
212
+ "tool.apply_mirror.param.center_x": "Center X position as fraction (0-1). Default: 0.5 (center).",
213
+ "tool.apply_mirror.param.center_y": "Center Y position as fraction (0-1). Default: 0.5 (center).",
214
+ "tool.apply_mirror.param.clip_index": "Clip index on the track (0-based)",
215
+ "tool.apply_mirror.param.track_index": "Video track index (0-based)",
216
+ "tool.apply_sharpen": "Apply Sharpen video effect to a clip to increase edge definition.",
217
+ "tool.apply_sharpen.param.amount": "Sharpening amount. Default: 50.",
218
+ "tool.apply_sharpen.param.clip_index": "Clip index on the track (0-based)",
219
+ "tool.apply_sharpen.param.track_index": "Video track index (0-based)",
220
+ "tool.apply_spherize": "Apply Spherize effect to a video clip to create a spherical/fisheye distortion.",
221
+ "tool.apply_spherize.param.center_x": "Center X position as fraction (0-1). Default: 0.5.",
222
+ "tool.apply_spherize.param.center_y": "Center Y position as fraction (0-1). Default: 0.5.",
223
+ "tool.apply_spherize.param.clip_index": "Clip index on the track (0-based)",
224
+ "tool.apply_spherize.param.radius": "Sphere radius as percentage. Default: 50.",
225
+ "tool.apply_spherize.param.track_index": "Video track index (0-based)",
226
+ "tool.apply_transition_to_all_cuts": "Apply a video transition to all cut points on a video track.",
227
+ "tool.apply_transition_to_all_cuts.param.duration": "Transition duration in seconds. Default: 1.0.",
228
+ "tool.apply_transition_to_all_cuts.param.track_index": "Video track index (0-based)",
229
+ "tool.apply_transition_to_all_cuts.param.transition_name": "Name of transition to apply (e.g. 'Cross Dissolve')",
230
+ "tool.apply_unsharp_mask": "Apply Unsharp Mask video effect to a clip for controlled sharpening with radius and threshold.",
231
+ "tool.apply_unsharp_mask.param.amount": "Sharpening amount percentage. Default: 100.",
232
+ "tool.apply_unsharp_mask.param.clip_index": "Clip index on the track (0-based)",
233
+ "tool.apply_unsharp_mask.param.radius": "Radius of sharpening in pixels. Default: 2.0.",
234
+ "tool.apply_unsharp_mask.param.threshold": "Threshold for edge detection. Default: 3.",
235
+ "tool.apply_unsharp_mask.param.track_index": "Video track index (0-based)",
236
+ "tool.apply_video_noise_reduction": "Apply Median video effect to reduce digital noise/grain in a clip.",
237
+ "tool.apply_video_noise_reduction.param.amount": "Noise reduction radius (1-5). Default: 2.",
238
+ "tool.apply_video_noise_reduction.param.clip_index": "Clip index on the track (0-based)",
239
+ "tool.apply_video_noise_reduction.param.track_index": "Video track index (0-based)",
240
+ "tool.apply_warp_stabilizer": "Apply Warp Stabilizer effect to a video clip to reduce camera shake. Smoothness controls how much stabilization is applied.",
241
+ "tool.apply_warp_stabilizer.param.clip_index": "Clip index on the track (0-based)",
242
+ "tool.apply_warp_stabilizer.param.smoothness": "Stabilization smoothness 0-100. Default: 50. Higher = more stable but more cropping.",
243
+ "tool.apply_warp_stabilizer.param.track_index": "Video track index (0-based)",
244
+ "tool.attach_custom_property": "Attach a custom property (key/value pair) to the active sequence",
245
+ "tool.attach_custom_property.param.property_id": "Unique identifier for the custom property",
246
+ "tool.attach_custom_property.param.property_value": "Value for the custom property",
247
+ "tool.attach_proxy": "Attach an existing proxy file to a project item.",
248
+ "tool.attach_proxy.param.project_item_index": "Project item index (0-based, from root item children)",
249
+ "tool.attach_proxy.param.proxy_path": "Full path to the proxy media file",
250
+ "tool.auto_reframe_sequence": "Auto-reframe a sequence for a different aspect ratio",
251
+ "tool.auto_reframe_sequence.param.quality": "Motion-tracking quality: 0=Default, 1=More Accurate, 2=Faster. Defaults to 0.",
252
+ "tool.auto_reframe_sequence.param.sequence_id": "Sequence name or ID to reframe. Uses active sequence if omitted.",
253
+ "tool.auto_reframe_sequence.param.target_height": "Target frame height in pixels",
254
+ "tool.auto_reframe_sequence.param.target_width": "Target frame width in pixels",
255
+ "tool.batch_add_transitions": "Add the same transition to all cut points on a track",
256
+ "tool.batch_add_transitions.param.duration_seconds": "Duration of each transition in seconds (default: 1.0)",
257
+ "tool.batch_add_transitions.param.track_index": "Video track index (0-based, default: 0)",
258
+ "tool.batch_add_transitions.param.transition_name": "Name of the transition (e.g., 'Cross Dissolve')",
259
+ "tool.batch_apply_effect": "Apply an effect to multiple clips at once. Can target selected clips, all clips on a track, or all clips in the sequence.",
260
+ "tool.batch_apply_effect.param.effect_name": "Display name of the effect to apply (e.g., 'Gaussian Blur', 'Lumetri Color')",
261
+ "tool.batch_apply_effect.param.target": "Which clips to apply to: selected clips, all on a track, or all in sequence",
262
+ "tool.batch_apply_effect.param.track_index": "Track index (required when target is 'track')",
263
+ "tool.batch_apply_effect.param.track_type": "Track type (required when target is 'track')",
264
+ "tool.batch_enable_disable": "Enable or disable multiple clips at once (selected, track, or all).",
265
+ "tool.batch_enable_disable.param.enabled": "true to enable, false to disable",
266
+ "tool.batch_enable_disable.param.target": "Which clips to affect",
267
+ "tool.batch_enable_disable.param.track_index": "Track index (required when target is 'track')",
268
+ "tool.batch_enable_disable.param.track_type": "Track type (required when target is 'track')",
269
+ "tool.batch_export_sequences": "Export multiple sequences to a directory in batch. Each sequence is exported to a file named after the sequence.",
270
+ "tool.batch_export_sequences.param.output_dir": "Output directory path where all exports will be saved",
271
+ "tool.batch_export_sequences.param.preset_path": "Path to export preset file (.epr)",
272
+ "tool.batch_export_sequences.param.sequence_indices": "Array of sequence indices to export",
273
+ "tool.batch_rename_clips": "Rename multiple clips on the timeline using a pattern. Supports sequential numbering.",
274
+ "tool.batch_rename_clips.param.pattern": "Name pattern. Use {n} for sequential number, {name} for original name (e.g., 'Scene_{n}', '{name}_v2')",
275
+ "tool.batch_rename_clips.param.selected_only": "Only rename selected clips (default: false, renames all on track)",
276
+ "tool.batch_rename_clips.param.start_number": "Starting number for {n} placeholder (default: 1)",
277
+ "tool.batch_rename_clips.param.track_index": "Track index (0-based)",
278
+ "tool.batch_rename_clips.param.track_type": "Track type to rename clips on",
279
+ "tool.capture_frame": "Capture the current frame and return it as inline image data for the LLM to see. This lets the AI visually inspect the current state of the timeline.",
280
+ "tool.capture_frame.param.time_seconds": "Time position in seconds to capture. Uses current playhead if omitted.",
281
+ "tool.center_clip": "Center a video clip in the frame (set position to sequence center).",
282
+ "tool.center_clip.param.clip_index": "Clip index on the track (0-based)",
283
+ "tool.center_clip.param.track_index": "Video track index (0-based)",
284
+ "tool.check_offline_media": "Check for offline (missing) media in the project",
285
+ "tool.clear_item_in_out": "Clear in and/or out points on a project item (reset to full duration).",
286
+ "tool.clear_item_in_out.param.clear_in": "Clear the in point (default: true)",
287
+ "tool.clear_item_in_out.param.clear_out": "Clear the out point (default: true)",
288
+ "tool.clear_item_in_out.param.item_id": "Node ID or name of the project item",
289
+ "tool.clear_media_cache": "Clear the Premiere Pro media cache to free up disk space.",
290
+ "tool.clear_sequence_in_out": "Clear the in and/or out points on the active sequence.",
291
+ "tool.clear_sequence_in_out.param.clear_in": "Clear in point (default: true)",
292
+ "tool.clear_sequence_in_out.param.clear_out": "Clear out point (default: true)",
293
+ "tool.close_all_gaps": "Close all gaps on a track.",
294
+ "tool.close_all_gaps.param.track_index": "Track index (0-based)",
295
+ "tool.close_all_gaps.param.track_type": "Track type: 'video' or 'audio'",
296
+ "tool.close_all_source_clips": "Close all clips in the Source Monitor.",
297
+ "tool.close_gap": "Close a specific gap on a track. Uses QE DOM extract to ripple-delete the gap range.",
298
+ "tool.close_gap.param.gap_index": "Gap index as returned by find_gaps (0-based)",
299
+ "tool.close_gap.param.track_index": "Track index (0-based)",
300
+ "tool.close_gap.param.track_type": "Track type: 'video' or 'audio'",
301
+ "tool.close_project": "Close the current Premiere Pro project",
302
+ "tool.close_project.param.save_first": "Whether to save before closing (default: true)",
303
+ "tool.close_sequence": "Close a sequence tab in the timeline",
304
+ "tool.close_sequence.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
305
+ "tool.close_source_monitor": "Close the clip currently open in the Source Monitor.",
306
+ "tool.color_correct": "Apply color correction to a clip using Lumetri Color. Automatically applies the Lumetri Color effect if not already present, then sets the specified parameters.\n\nPreconditions: Active sequence required. Clip must exist on the timeline.\n\nAll parameters are optional — only the ones you provide will be changed. Values outside their valid range are clamped by Premiere Pro.\n\nParameter ranges:\n- exposure: -5.0 to +5.0 (EV stops; 0 = no change)\n- contrast: -100 to +100 (0 = no change)\n- highlights: -100 to +100\n- shadows: -100 to +100\n- whites: -100 to +100\n- blacks: -100 to +100\n- temperature: -100 to +100 (negative = cooler/blue, positive = warmer/orange)\n- tint: -100 to +100 (negative = green, positive = magenta)\n- saturation: 0 to 200 (100 = no change, 0 = grayscale)\n\nExample: color_correct({ node_id: \"abc123\", exposure: 0.5, contrast: 10, saturation: 110 })\nExample: color_correct({ node_id: \"abc123\", temperature: -20, highlights: -30, shadows: 15 })",
307
+ "tool.color_correct.param.blacks": "Blacks adjustment (-100 to 100)",
308
+ "tool.color_correct.param.contrast": "Contrast adjustment (-100 to 100)",
309
+ "tool.color_correct.param.exposure": "Exposure adjustment (-4.0 to 4.0)",
310
+ "tool.color_correct.param.highlights": "Highlights adjustment (-100 to 100)",
311
+ "tool.color_correct.param.node_id": "Node ID of the clip",
312
+ "tool.color_correct.param.saturation": "Saturation (0-200, 100 = normal)",
313
+ "tool.color_correct.param.shadows": "Shadows adjustment (-100 to 100)",
314
+ "tool.color_correct.param.temperature": "Color temperature adjustment",
315
+ "tool.color_correct.param.tint": "Tint adjustment",
316
+ "tool.color_correct.param.whites": "Whites adjustment (-100 to 100)",
317
+ "tool.conform_sequence_to_clip": "Change the sequence settings to match the properties of a specific project item (resolution, frame rate).",
318
+ "tool.conform_sequence_to_clip.param.project_item_index": "Project item index (0-based) whose properties to match",
319
+ "tool.consolidate_and_transfer": "Consolidate, copy, or transcode project media using the Project Manager. Useful for archiving or transferring projects.",
320
+ "tool.consolidate_and_transfer.param.convert_ae_comps": "Convert After Effects compositions (default: false)",
321
+ "tool.consolidate_and_transfer.param.convert_image_sequences": "Convert image sequences to clips (default: false)",
322
+ "tool.consolidate_and_transfer.param.convert_synthetic": "Convert synthetic importer items (default: false)",
323
+ "tool.consolidate_and_transfer.param.copy_to_new_location": "Copy media to a new location (default: true)",
324
+ "tool.consolidate_and_transfer.param.destination_path": "Destination folder path for the consolidated project",
325
+ "tool.consolidate_and_transfer.param.exclude_unused": "Exclude unused clips (default: true)",
326
+ "tool.consolidate_and_transfer.param.include_all_sequences": "Include all sequences (default: true). If false, only active sequence is used.",
327
+ "tool.consolidate_and_transfer.param.include_preview_files": "Include preview/render files (default: false)",
328
+ "tool.consolidate_and_transfer.param.rename_media": "Rename media to match clip names (default: false)",
329
+ "tool.consolidate_and_transfer.param.transcode": "Transcode media during copy (default: false)",
330
+ "tool.consolidate_duplicates": "Consolidate duplicate project items",
331
+ "tool.convert_stereo_to_mono": "Convert a stereo project item to mono by duplicating it as mono channels.",
332
+ "tool.convert_stereo_to_mono.param.project_item_index": "Project item index (0-based, from root item children)",
333
+ "tool.copy_color_grade": "Copy the Lumetri Color grade from a source clip. Use paste_color_grade afterward to apply it to other clips.",
334
+ "tool.copy_color_grade.param.clip_index": "Source clip index on the track (0-based)",
335
+ "tool.copy_color_grade.param.track_index": "Source video track index (0-based)",
336
+ "tool.copy_effect_values": "Copy all property values from one effect to the matching effect on another clip. Both clips must already have the same effect applied.",
337
+ "tool.copy_effect_values.param.effect_name": "Display name of the effect to copy values for",
338
+ "tool.copy_effect_values.param.source_node_id": "Node ID of the source clip",
339
+ "tool.copy_effect_values.param.target_node_id": "Node ID of the target clip",
340
+ "tool.copy_effects_between_clips": "Copy all effects (or a specific effect) from one clip to another. Does not copy intrinsic properties like Motion/Opacity unless specified.",
341
+ "tool.copy_effects_between_clips.param.effect_name": "Specific effect display name to copy (copies all non-intrinsic effects if omitted)",
342
+ "tool.copy_effects_between_clips.param.source_node_id": "Node ID of the source clip to copy effects from",
343
+ "tool.copy_effects_between_clips.param.target_node_id": "Node ID of the target clip to paste effects to",
344
+ "tool.create_bars_and_tone": "Create a Bars and Tone synthetic media item in the project (useful for leader/calibration)",
345
+ "tool.create_bars_and_tone.param.height": "Frame height in pixels (default: 1080)",
346
+ "tool.create_bars_and_tone.param.name": "Name for the bars and tone item (default: 'Bars and Tone')",
347
+ "tool.create_bars_and_tone.param.timebase": "Timebase as ticks-per-second string (default uses sequence timebase)",
348
+ "tool.create_bars_and_tone.param.width": "Frame width in pixels (default: 1920)",
349
+ "tool.create_bin": "Create a new bin (folder) in the project panel",
350
+ "tool.create_bin.param.name": "Name of the new bin",
351
+ "tool.create_bin.param.parent_bin": "Optional parent bin name or node ID. Creates in root if omitted.",
352
+ "tool.create_caption_track": "Create a caption/subtitle track in the active sequence from an imported caption file (e.g., .srt, .vtt)",
353
+ "tool.create_caption_track.param.caption_format": "Caption format: 'subtitle' (default), '608', '708', 'teletext', 'ebu', 'op42', 'op47'",
354
+ "tool.create_caption_track.param.item_id": "Node ID or name of the imported caption project item (e.g., an .srt file)",
355
+ "tool.create_caption_track.param.start_seconds": "Offset in seconds from the start of the sequence (default: 0)",
356
+ "tool.create_multicam_sequence": "Create a multicam sequence from multiple project items. Clips are synced based on the specified sync point method.",
357
+ "tool.create_multicam_sequence.param.clip_indices": "Array of project item indices (from root item) to include as camera angles. At least 2 required.",
358
+ "tool.create_multicam_sequence.param.name": "Name for the new multicam sequence. Default: 'Multicam Sequence'.",
359
+ "tool.create_multicam_sequence.param.sync_point": "How to sync the clips: 'inPoint', 'outPoint', 'timecode', or 'marker'. Default: 'inPoint'.",
360
+ "tool.create_pip": "Create a Picture-in-Picture (PIP) effect by scaling and repositioning a clip. The clip is placed at a corner at reduced size.",
361
+ "tool.create_pip.param.main_clip_index": "Main clip index (0-based)",
362
+ "tool.create_pip.param.main_track_index": "Main (background) video track index (0-based)",
363
+ "tool.create_pip.param.pip_clip_index": "PIP clip index (0-based)",
364
+ "tool.create_pip.param.pip_track_index": "PIP (foreground) video track index (0-based)",
365
+ "tool.create_pip.param.position": "Corner position: 'top-left', 'top-right', 'bottom-left', 'bottom-right', or 'center'. Default: 'bottom-right'.",
366
+ "tool.create_pip.param.scale": "PIP scale as percentage of frame. Default: 30.",
367
+ "tool.create_project": "Create a new Premiere Pro project at the specified path",
368
+ "tool.create_project.param.path": "Full file path for the new .prproj file",
369
+ "tool.create_proxy": "Create a proxy file for a project item using a specified encoding preset. Proxies enable low-res editing with high-res final output.",
370
+ "tool.create_proxy.param.preset_path": "Path to the encoding preset file for proxy creation",
371
+ "tool.create_proxy.param.project_item_index": "Project item index (0-based, from root item children)",
372
+ "tool.create_sequence": "Create a new empty sequence in the project and make it the active sequence.\n\nUses qe.project.newSequence() which works without dialogs in Premiere Pro 2026.\n\nIf no preset_path is provided, uses the HD 1080p 23.976fps preset. To create a specific format, pass the full path to a .sqpreset file.\n\nCommon preset paths:\n- Windows 1920x1080 24fps: C:\\Program Files\\Adobe\\Adobe Premiere Pro 2026\\Settings\\SequencePresets\\HD 1080p\\HD 1080p 23.976 fps.sqpreset\n- Windows 1080x1920 (9:16): C:\\Program Files\\Adobe\\Adobe Premiere Pro 2026\\Settings\\SequencePresets\\Social\\Social Media Portrait 9x16 30 fps.sqpreset\n- macOS 1920x1080 24fps: /Applications/Adobe Premiere Pro 2026/Adobe Premiere Pro 2026.app/Contents/SequencePresets/HD 1080p/HD 1080p 23.976 fps.sqpreset\n- macOS 1080x1920 (9:16): /Applications/Adobe Premiere Pro 2026/Adobe Premiere Pro 2026.app/Contents/SequencePresets/Social/Social Media Portrait 9x16 30 fps.sqpreset\n\nExample: create_sequence({ name: \"Main Edit\" })\nExample (Windows): create_sequence({ name: \"Vertical\", preset_path: \"C:\\\\Program Files\\\\Adobe\\\\Adobe Premiere Pro 2026\\\\Settings\\\\SequencePresets\\\\Social\\\\Social Media Portrait 9x16 30 fps.sqpreset\" })\nExample (macOS): create_sequence({ name: \"Vertical\", preset_path: \"/Applications/Adobe Premiere Pro 2026/Adobe Premiere Pro 2026.app/Contents/SequencePresets/Social/Social Media Portrait 9x16 30 fps.sqpreset\" })",
373
+ "tool.create_sequence.param.name": "Name for the new sequence",
374
+ "tool.create_sequence.param.preset_path": "Optional path to a sequence preset file (.sqpreset). Uses HD 1080p 23.976fps if omitted.",
375
+ "tool.create_sequence_from_clip": "Create a new sequence whose settings (resolution, frame rate, pixel aspect ratio, audio sample rate) exactly match a specific project item (clip).\n\nThis is the recommended way to create a sequence when you want it to match your source footage — it avoids transcoding or scaling artifacts that occur when sequence settings don't match the media.\n\nPreconditions: The clip must already be imported into the project (use import_media first). Use list_project_items to find the item_id.\n\nAfter creation, the new sequence becomes active automatically.\n\nExample: create_sequence_from_clip({ item_id: \"interview.mp4\", name: \"Interview Edit\" })\nExample: create_sequence_from_clip({ item_id: \"abc123-node-id\", name: \"4K Sequence\" })",
376
+ "tool.create_sequence_from_clip.param.item_id": "Node ID or name of the project item to match settings from",
377
+ "tool.create_sequence_from_clip.param.name": "Name for the new sequence",
378
+ "tool.create_sequence_from_clips": "Create a new sequence by automatically placing project items in order",
379
+ "tool.create_sequence_from_clips.param.item_ids": "Array of project item names or node IDs to include in order",
380
+ "tool.create_sequence_from_clips.param.name": "Name for the new sequence",
381
+ "tool.create_sequence_from_preset": "Create a new sequence from a specific preset file (.sqpreset). Uses qe.project.newSequence() — works without dialogs in PP 2026.",
382
+ "tool.create_sequence_from_preset.param.name": "Name for the new sequence",
383
+ "tool.create_sequence_from_preset.param.preset_path": "Full path to the .sqpreset file",
384
+ "tool.create_smart_bin": "Create a smart bin (search bin) in the project panel",
385
+ "tool.create_smart_bin.param.name": "Name for the smart bin",
386
+ "tool.create_smart_bin.param.query": "Search query for the smart bin",
387
+ "tool.create_subclip": "Create a subclip from a project item with in/out points",
388
+ "tool.create_subclip.param.in_seconds": "In-point in seconds",
389
+ "tool.create_subclip.param.item_id": "Node ID or name of the source project item",
390
+ "tool.create_subclip.param.name": "Name for the subclip",
391
+ "tool.create_subclip.param.out_seconds": "Out-point in seconds",
392
+ "tool.create_submix": "Create a submix (bus) track in the active sequence for routing multiple tracks.",
393
+ "tool.create_submix.param.channel_type": "Channel type: 'mono', 'stereo', '5.1', or 'adaptive'. Default: 'stereo'.",
394
+ "tool.create_submix.param.name": "Name for the submix track. Default: 'Submix'.",
395
+ "tool.create_subsequence": "Create a subsequence (nested sequence) from selected clips or a time range",
396
+ "tool.create_subsequence.param.ignore_track_targeting": "Whether to ignore track targeting (default: false)",
397
+ "tool.cross_fade_clips": "Create a cross-fade between two adjacent clips by animating opacity. Clip A fades out while Clip B fades in.",
398
+ "tool.cross_fade_clips.param.clip_index_a": "Index of the first clip (fades out)",
399
+ "tool.cross_fade_clips.param.clip_index_b": "Index of the second clip (fades in)",
400
+ "tool.cross_fade_clips.param.duration_seconds": "Duration of the cross-fade in seconds. Default: 1.0.",
401
+ "tool.cross_fade_clips.param.track_index": "Video track index (0-based)",
402
+ "tool.delete_all_clips_between": "Delete all clips on a track between two time points.",
403
+ "tool.delete_all_clips_between.param.end_seconds": "End time in seconds",
404
+ "tool.delete_all_clips_between.param.start_seconds": "Start time in seconds",
405
+ "tool.delete_all_clips_between.param.track_index": "Track index (0-based)",
406
+ "tool.delete_all_clips_between.param.track_type": "Track type: 'video' or 'audio'",
407
+ "tool.delete_bin": "Delete a bin (folder) from the project panel",
408
+ "tool.delete_bin.param.bin_id": "Name or node ID of the bin to delete",
409
+ "tool.delete_marker": "Delete a marker at a specific time position",
410
+ "tool.delete_marker.param.node_id": "Optional clip node ID (deletes from sequence if omitted)",
411
+ "tool.delete_marker.param.time_seconds": "Time position of the marker to delete",
412
+ "tool.delete_multiple_project_items": "Delete multiple project items at once from the project panel.",
413
+ "tool.delete_multiple_project_items.param.item_ids": "Array of node IDs or names of items to delete",
414
+ "tool.delete_preview_files": "Delete all preview/render cache files for the project. Uses QE DOM.",
415
+ "tool.delete_preview_files.param.media_type": "Type of preview files to delete: 'video', 'audio', or 'all' (default: 'all')",
416
+ "tool.delete_project_item": "Delete a project item (clip, bin, etc.) from the project panel. This removes it from the project but does not affect timeline instances.",
417
+ "tool.delete_project_item.param.item_id": "Node ID or name of the project item to delete",
418
+ "tool.delete_sequence": "Delete a sequence from the project",
419
+ "tool.delete_sequence.param.sequence_id": "Sequence name or ID to delete",
420
+ "tool.delete_track": "Delete a video or audio track from the active sequence",
421
+ "tool.delete_track.param.track_index": "Index of the track to delete (0-based)",
422
+ "tool.delete_track.param.track_type": "Type of track to delete",
423
+ "tool.deselect_all_clips": "Deselect all clips in the active sequence.",
424
+ "tool.detach_proxy": "Detach/remove the proxy from a project item (reverts to original media).",
425
+ "tool.detach_proxy.param.project_item_index": "Project item index (0-based, from root item children)",
426
+ "tool.detect_clipping": "Detect potential audio clipping in a clip. Returns whether the clip level could cause clipping.",
427
+ "tool.detect_clipping.param.clip_index": "Clip index on the track (0-based)",
428
+ "tool.detect_clipping.param.track_index": "Audio track index (0-based)",
429
+ "tool.detect_scene_edits": "Automatically detect scene changes in a clip and create cut points. Useful for splitting footage recorded continuously.",
430
+ "tool.detect_scene_edits.param.clip_index": "Clip index on the track (0-based)",
431
+ "tool.detect_scene_edits.param.sensitivity": "Detection sensitivity 0-100. Higher = more sensitive, detects more cuts. Default: 50.",
432
+ "tool.detect_scene_edits.param.track_index": "Video track index (0-based)",
433
+ "tool.duplicate_clip": "Duplicate a clip on the timeline (copy to same position on next available track)",
434
+ "tool.duplicate_clip.param.node_id": "Node ID of the clip to duplicate",
435
+ "tool.duplicate_sequence": "Duplicate an existing sequence",
436
+ "tool.duplicate_sequence.param.sequence_id": "Sequence name or ID to duplicate",
437
+ "tool.enable_disable_clip": "Enable or disable a clip on the timeline",
438
+ "tool.enable_disable_clip.param.enabled": "Set to true to enable, false to disable",
439
+ "tool.enable_disable_clip.param.node_id": "Node ID of the clip",
440
+ "tool.encode_file": "Encode an external file (not in project) using Adobe Media Encoder",
441
+ "tool.encode_file.param.in_seconds": "Optional start time in seconds",
442
+ "tool.encode_file.param.input_path": "Full path to the input file",
443
+ "tool.encode_file.param.out_seconds": "Optional end time in seconds",
444
+ "tool.encode_file.param.output_path": "Full output file path",
445
+ "tool.encode_file.param.preset_path": "Path to an AME preset file (.epr)",
446
+ "tool.encode_file.param.remove_on_completion": "Remove from queue on completion (default: true)",
447
+ "tool.encode_project_item": "Encode a specific project item (not a sequence) using Adobe Media Encoder",
448
+ "tool.encode_project_item.param.item_id": "Node ID or name of the project item to encode",
449
+ "tool.encode_project_item.param.output_path": "Full output file path",
450
+ "tool.encode_project_item.param.preset_path": "Path to an AME preset file (.epr)",
451
+ "tool.encode_project_item.param.remove_on_completion": "Remove from queue on completion (default: true)",
452
+ "tool.evaluate_expression": "Evaluate a simple ExtendScript expression and return its value. Use for quick queries like checking a property, getting a count, or reading state. The expression should be a single value/call — NOT a full script.\n\nExamples:\n- \"app.project.name\" → project name\n- \"app.project.activeSequence.name\" → active sequence name\n- \"app.project.rootItem.children.numItems\" → number of root items\n- \"app.project.activeSequence.videoTracks.numTracks\" → number of video tracks\n- \"app.version\" → Premiere Pro version",
453
+ "tool.evaluate_expression.param.expression": "ExtendScript expression to evaluate (e.g., 'app.project.name')",
454
+ "tool.execute_extendscript": "Execute custom ExtendScript code in Premiere Pro. The code runs inside an IIFE with helper functions available.\n\nIMPORTANT: You MUST write ES3 syntax (var instead of let/const, no arrow functions, no template literals, no destructuring).\n\nAvailable helpers (auto-prepended):\n- __ticksToSeconds(ticks) / __secondsToTicks(seconds) — time conversion\n- __ticksToTimecode(ticks, fps) — timecode string\n- __findSequence(idOrName) — find sequence by name or ID\n- __findProjectItem(nodeIdOrName) — find project item recursively\n- __findClip(nodeId) — find clip in active sequence, returns {clip, trackIndex, clipIndex, trackType}\n- __getAllClips(seq) — get all clips in a sequence\n- __result(data) — return success with data (MUST call this or __error)\n- __error(msg) — return error message\n- TICKS_PER_SECOND — constant 254016000000\n- app.enableQE() — enable QE DOM access\n\nYour code MUST end with: return __result({...}) or return __error(\"message\")\n\nExample: Set opacity to 50% on all video clips\n var seq = app.project.activeSequence;\n if (!seq) return __error(\"No active sequence\");\n var count = 0;\n for (var t = 0; t < seq.videoTracks.numTracks; t++) {\n var track = seq.videoTracks[t];\n for (var c = 0; c < track.clips.numItems; c++) {\n var clip = track.clips[c];\n for (var i = 0; i < clip.components.numItems; i++) {\n var comp = clip.components[i];\n if (comp.displayName === \"Opacity\") {\n for (var p = 0; p < comp.properties.numItems; p++) {\n if (comp.properties[p].displayName === \"Opacity\") {\n comp.properties[p].setValue(50, true);\n count++;\n }\n }\n }\n }\n }\n }\n return __result({updated: count});",
455
+ "tool.execute_extendscript.param.code": "ExtendScript code to execute (ES3 syntax). Must use return __result({...}) or return __error('...'). Helpers are auto-prepended.",
456
+ "tool.execute_extendscript.param.timeout_ms": "Custom timeout in milliseconds (default: 30000). Increase for long operations.",
457
+ "tool.export_aaf": "Export a sequence as AAF (Advanced Authoring Format) for interchange with other post-production tools.",
458
+ "tool.export_aaf.param.options": "Optional AAF export settings object",
459
+ "tool.export_aaf.param.output_path": "Full output path for the .aaf file",
460
+ "tool.export_aaf.param.sequence_index": "Sequence index to export (0-based). Default: 0.",
461
+ "tool.export_all_sequences": "Export all sequences in the project to a directory.",
462
+ "tool.export_all_sequences.param.output_dir": "Output directory path where all exports will be saved",
463
+ "tool.export_all_sequences.param.preset_path": "Path to export preset file (.epr)",
464
+ "tool.export_as_fcp_xml": "Export the active sequence as a Final Cut Pro XML file",
465
+ "tool.export_as_fcp_xml.param.output_path": "Full output file path (e.g., '/Users/me/export.xml')",
466
+ "tool.export_as_project": "Export a sequence as a standalone Premiere Pro project file",
467
+ "tool.export_as_project.param.output_path": "Full path for the exported .prproj file",
468
+ "tool.export_as_project.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
469
+ "tool.export_audio_only": "Export only the audio from a sequence using a specified preset.",
470
+ "tool.export_audio_only.param.output_path": "Full output file path (e.g. C:/output/audio.mp3)",
471
+ "tool.export_audio_only.param.preset_path": "Full path to audio export preset file (.epr)",
472
+ "tool.export_audio_only.param.sequence_index": "Sequence index to export (0-based). Default: 0.",
473
+ "tool.export_direct": "Export a sequence directly (without AME) using a preset file path. Faster than AME-based export but with fewer options.",
474
+ "tool.export_direct.param.output_path": "Full output file path (e.g. C:/output/video.mp4)",
475
+ "tool.export_direct.param.preset_path": "Full path to export preset file (.epr)",
476
+ "tool.export_direct.param.sequence_index": "Sequence index to export (0-based). Default: 0 (first sequence).",
477
+ "tool.export_direct.param.work_area_type": "Work area type: 0=entire sequence, 1=work area, 2=in/out. Default: 0.",
478
+ "tool.export_fcpxml": "Export a sequence as FCPXML format for import into Final Cut Pro X.",
479
+ "tool.export_fcpxml.param.output_path": "Full output path for the .fcpxml file",
480
+ "tool.export_frame": "Export the current frame as an image file",
481
+ "tool.export_frame.param.output_path": "Full output file path (e.g., '/Users/me/frame.png'). Extension determines format.",
482
+ "tool.export_frame.param.time_seconds": "Time position in seconds to export. Uses current playhead if omitted.",
483
+ "tool.export_markers_as_csv": "Export all sequence markers as a CSV file.",
484
+ "tool.export_markers_as_csv.param.output_path": "Full output path for the CSV file",
485
+ "tool.export_markers_as_edl": "Export sequence markers as EDL (Edit Decision List) format.",
486
+ "tool.export_markers_as_edl.param.output_path": "Full output path for the EDL file",
487
+ "tool.export_omf": "Export a sequence as OMF (Open Media Framework) for interchange with Pro Tools and other DAWs.",
488
+ "tool.export_omf.param.options": "Optional OMF export settings object",
489
+ "tool.export_omf.param.output_path": "Full output path for the .omf file",
490
+ "tool.export_omf.param.sequence_index": "Sequence index to export (0-based). Default: 0.",
491
+ "tool.export_sequence": "Export the active sequence to a file using Adobe Media Encoder (AME).\n\nPreconditions: An active sequence must exist. Adobe Media Encoder must be installed. The output directory must exist and be writable.\n\nExport runs asynchronously via AME — this tool queues and starts the export, but completion may take minutes. The tool returns after the export job is queued (not after it finishes).\n\nCommon preset paths:\n- macOS H.264 1080p: /Applications/Adobe Media Encoder [year]/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr\n- Windows H.264: C:\\Program Files\\Adobe\\Adobe Media Encoder [year]\\MediaIO\\systempresets\\4028\\HDTV 1080p 29.97 High Quality.epr\n\nIf preset_path is omitted, uses default H.264 1080p settings.\n\nParameters:\n- output_path: Absolute path for the output file including extension (e.g., .mp4, .mov, .mxf).\n- preset_path: Path to an AME .epr preset file. Determines codec, bitrate, and format.\n- work_area_only: If true, exports only the range between work area in/out points instead of the full sequence.\n\nExample: export_sequence({ output_path: \"C:\\\\Exports\\\\final.mp4\" })\nExample: export_sequence({ output_path: \"/Users/me/exports/prores.mov\", preset_path: \"/path/to/ProRes422.epr\", work_area_only: false })",
492
+ "tool.export_sequence.param.output_path": "Full output file path (e.g., '/Users/me/exports/video.mp4')",
493
+ "tool.export_sequence.param.preset_path": "Path to an AME preset file (.epr). Uses default H.264 if omitted.",
494
+ "tool.export_sequence.param.work_area_only": "Export only the work area (default: false, exports entire sequence)",
495
+ "tool.export_via_ame": "Export a sequence via Adobe Media Encoder (AME). AME must be installed. Supports more formats and presets.",
496
+ "tool.export_via_ame.param.output_path": "Full output file path",
497
+ "tool.export_via_ame.param.preset_path": "Full path to export preset file (.epr)",
498
+ "tool.export_via_ame.param.remove_on_done": "Remove the item from AME queue after encoding. Default: false.",
499
+ "tool.export_via_ame.param.sequence_index": "Sequence index to export (0-based). Default: 0.",
500
+ "tool.export_via_ame.param.work_area_type": "Work area type: 0=entire sequence, 1=work area, 2=in/out. Default: 0.",
501
+ "tool.extract_audio_from_video": "Extract the audio from a video project item as a separate audio clip in the project.",
502
+ "tool.extract_audio_from_video.param.project_item_index": "Project item index (0-based, from root item children)",
503
+ "tool.extract_selection": "Extract (remove and close gap) the content between sequence in/out points.",
504
+ "tool.fade_in": "Add a video fade-in to a clip by animating opacity from 0 to 100% over the specified duration.",
505
+ "tool.fade_in.param.clip_index": "Clip index on the track (0-based)",
506
+ "tool.fade_in.param.duration_seconds": "Duration of the fade-in in seconds. Default: 1.0.",
507
+ "tool.fade_in.param.track_index": "Video track index (0-based)",
508
+ "tool.fade_in_audio": "Add volume keyframes for a fade-in at the start of an audio clip.",
509
+ "tool.fade_in_audio.param.clip_index": "Clip index on the track (0-based)",
510
+ "tool.fade_in_audio.param.duration_seconds": "Fade-in duration in seconds",
511
+ "tool.fade_in_audio.param.target_db": "Target level in dB at end of fade-in. Default: 0 dB.",
512
+ "tool.fade_in_audio.param.track_index": "Audio track index (0-based)",
513
+ "tool.fade_out": "Add a video fade-out to a clip by animating opacity from 100% to 0 at the end.",
514
+ "tool.fade_out.param.clip_index": "Clip index on the track (0-based)",
515
+ "tool.fade_out.param.duration_seconds": "Duration of the fade-out in seconds. Default: 1.0.",
516
+ "tool.fade_out.param.track_index": "Video track index (0-based)",
517
+ "tool.fade_out_audio": "Add volume keyframes for a fade-out at the end of an audio clip.",
518
+ "tool.fade_out_audio.param.clip_index": "Clip index on the track (0-based)",
519
+ "tool.fade_out_audio.param.duration_seconds": "Fade-out duration in seconds",
520
+ "tool.fade_out_audio.param.start_db": "Starting level in dB at beginning of fade-out. Default: 0 dB.",
521
+ "tool.fade_out_audio.param.track_index": "Audio track index (0-based)",
522
+ "tool.fill_frame": "Scale a clip to fill the sequence frame (cropping edges if needed, no letterbox).",
523
+ "tool.fill_frame.param.clip_index": "Clip index on the track (0-based)",
524
+ "tool.fill_frame.param.track_index": "Video track index (0-based)",
525
+ "tool.find_gaps": "Find gaps (empty spaces) on a track in the timeline.",
526
+ "tool.find_gaps.param.track_index": "Track index (0-based)",
527
+ "tool.find_gaps.param.track_type": "Track type: 'video' or 'audio'",
528
+ "tool.find_items_by_media_path": "Find project items whose media path contains the given search string",
529
+ "tool.find_items_by_media_path.param.path_search": "Partial file path to search for",
530
+ "tool.find_project_item_by_name": "Find a project item by name (searches recursively through bins)",
531
+ "tool.find_project_item_by_name.param.name": "Name of the project item to find",
532
+ "tool.fit_clip_to_frame": "Scale a clip to fit the sequence frame while maintaining aspect ratio (letterbox/pillarbox).",
533
+ "tool.fit_clip_to_frame.param.clip_index": "Clip index on the track (0-based)",
534
+ "tool.fit_clip_to_frame.param.track_index": "Video track index (0-based)",
535
+ "tool.flatten_multicam": "Flatten a multicam sequence into a regular single-camera sequence. This bakes all the camera switches.",
536
+ "tool.flatten_multicam.param.sequence_index": "Index of the multicam sequence to flatten (0-based, from project sequences list)",
537
+ "tool.freeze_frame": "Freeze a frame at a specific time on a clip for a specified duration.",
538
+ "tool.freeze_frame.param.clip_index": "Clip index on the track (0-based)",
539
+ "tool.freeze_frame.param.duration": "Duration of the freeze frame in seconds. Default: 2.0.",
540
+ "tool.freeze_frame.param.time": "Time in seconds where the freeze frame occurs",
541
+ "tool.freeze_frame.param.track_index": "Video track index (0-based)",
542
+ "tool.get_active_sequence": "Get detailed information about the currently active sequence",
543
+ "tool.get_all_clips": "Get all clips from all tracks in the active sequence.",
544
+ "tool.get_all_project_paths": "Get all unique media file paths used in the project. Useful for asset management and archiving.",
545
+ "tool.get_audio_effect_presets": "List available audio effect presets that can be applied to clips. Shows which effects are installed.",
546
+ "tool.get_audio_mixer_state": "Get the current state of the audio mixer for the active sequence. Returns all track volumes, panning, mute/solo status.",
547
+ "tool.get_audio_track_info": "Get detailed info for one audio track including name, mute state, level, panning, and all clips.",
548
+ "tool.get_audio_track_info.param.track_index": "Audio track index (0-based)",
549
+ "tool.get_auto_save_settings": "Get the current auto-save settings including interval and maximum versions.",
550
+ "tool.get_bin_contents": "Get detailed contents of a specific bin (folder) including all nested items, media paths, offline status, color labels, and metadata. Searches by bin name or node ID.",
551
+ "tool.get_bin_contents.param.bin_id": "Bin name, node ID, or path (e.g., 'Footage', 'Footage/Raw')",
552
+ "tool.get_bin_contents.param.recursive": "Include items from sub-bins recursively (default: true)",
553
+ "tool.get_clip_adjustment_layer": "Check if a clip is an adjustment layer",
554
+ "tool.get_clip_adjustment_layer.param.node_id": "Node ID of the clip",
555
+ "tool.get_clip_at_playhead": "Get all clips at the current playhead position across all tracks.",
556
+ "tool.get_clip_at_playhead.param.track_type": "Track type to check (default: both)",
557
+ "tool.get_clip_at_position": "Get the clip at a specific time position on a track",
558
+ "tool.get_clip_at_position.param.time_seconds": "Time position in seconds",
559
+ "tool.get_clip_at_position.param.track_index": "Track index (0-based)",
560
+ "tool.get_clip_at_position.param.track_type": "Track type",
561
+ "tool.get_clip_links": "Get information about linked clips (audio/video linked together) for a given clip.",
562
+ "tool.get_clip_links.param.node_id": "Node ID of the clip",
563
+ "tool.get_clip_markers": "Get all markers on a specific project item (source clip markers, not sequence markers).",
564
+ "tool.get_clip_markers.param.item_id": "Node ID or name of the project item",
565
+ "tool.get_clip_panning": "Get the current stereo panning value for an audio clip.",
566
+ "tool.get_clip_panning.param.clip_index": "Clip index on the track (0-based)",
567
+ "tool.get_clip_panning.param.track_index": "Audio track index (0-based)",
568
+ "tool.get_clip_properties": "Get detailed properties of a specific clip by its node ID",
569
+ "tool.get_clip_properties.param.node_id": "The node ID of the clip",
570
+ "tool.get_clip_speed": "Get the playback speed and reverse state of a clip",
571
+ "tool.get_clip_speed.param.node_id": "Node ID of the clip",
572
+ "tool.get_clips_on_track": "Get information about all clips on a specific track.",
573
+ "tool.get_clips_on_track.param.track_index": "Track index (0-based)",
574
+ "tool.get_clips_on_track.param.track_type": "Track type: 'video' or 'audio'",
575
+ "tool.get_color_info": "Get color information and Lumetri Color settings for a clip.",
576
+ "tool.get_color_info.param.clip_index": "Clip index on the track (0-based)",
577
+ "tool.get_color_info.param.track_index": "Video track index (0-based)",
578
+ "tool.get_color_label": "Get the color label of a project item",
579
+ "tool.get_color_label.param.item_id": "Node ID or name of the project item",
580
+ "tool.get_color_space": "Get the color space information for a project item",
581
+ "tool.get_color_space.param.item_id": "Node ID or name of the project item",
582
+ "tool.get_crop": "Get the current crop values for a clip.",
583
+ "tool.get_crop.param.clip_index": "Clip index on the track (0-based)",
584
+ "tool.get_crop.param.track_index": "Video track index (0-based)",
585
+ "tool.get_current_timecode": "Get the current playhead position as a formatted timecode string.",
586
+ "tool.get_default_sequence_presets": "Get the list of built-in default sequence presets available for creating new sequences.",
587
+ "tool.get_duplicate_media": "Find project items that reference the same source media file. Useful for consolidation.",
588
+ "tool.get_effect_properties": "List all properties of a specific effect on a clip, including current values",
589
+ "tool.get_effect_properties.param.effect_name": "Display name of the effect (e.g., 'Motion', 'Opacity', 'Lumetri Color')",
590
+ "tool.get_effect_properties.param.node_id": "Node ID of the clip",
591
+ "tool.get_encoder_presets": "List available Adobe Media Encoder export presets for a given format.",
592
+ "tool.get_encoder_presets.param.format": "Format name to list presets for (e.g., 'H.264', 'QuickTime', 'MPEG2'). Leave empty to list formats.",
593
+ "tool.get_export_file_extension": "Get the file extension that would be used when exporting the active sequence with a given preset",
594
+ "tool.get_export_file_extension.param.preset_path": "Full path to the export preset file (.epr)",
595
+ "tool.get_export_presets": "Get available export presets for a specific exporter.",
596
+ "tool.get_export_presets.param.exporter_index": "Exporter index from get_exporters (0-based). Default: 0 (H.264).",
597
+ "tool.get_exporters": "Get a list of all available export formats/encoders in Premiere Pro.",
598
+ "tool.get_footage_interpretation": "Get footage interpretation settings for a project item",
599
+ "tool.get_footage_interpretation.param.item_id": "Node ID or name of the project item",
600
+ "tool.get_frame_count": "Get the total number of frames in the active sequence.",
601
+ "tool.get_full_clip_info": "Get exhaustive information about a specific clip: all effects with every property value, source media details, footage interpretation, metadata, markers, speed, enabled state, color label, linked clips, and proxy status.",
602
+ "tool.get_full_clip_info.param.node_id": "Node ID of the clip on the timeline",
603
+ "tool.get_full_project_overview": "Get a comprehensive overview of the entire project: all bins (recursive tree), all sequences, media stats, offline items, and project settings. This is the best first call to fully understand a project.",
604
+ "tool.get_full_sequence_info": "Get exhaustive information about a sequence: settings, all tracks with lock/mute/target state, all clips with positions/effects/speed/enabled state, all markers, transitions, in/out points, and work area.",
605
+ "tool.get_full_sequence_info.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
606
+ "tool.get_general_preferences": "Get general Premiere Pro application preferences like default durations, app version, and current sequence settings.",
607
+ "tool.get_gpu_info": "Get information about the GPU available for Mercury GPU Acceleration.",
608
+ "tool.get_graphics_white_luminance": "Get the graphics white luminance value (HDR setting) for the project",
609
+ "tool.get_insertion_bin": "Get the current target bin for new imports (the bin that is currently focused in the Project panel)",
610
+ "tool.get_installed_codecs": "Get a list of installed video/audio codecs available for export.",
611
+ "tool.get_item_info": "Get detailed type info about a project item (is it a sequence, multicam, merged clip, etc.)",
612
+ "tool.get_item_info.param.item_id": "Node ID or name of the project item",
613
+ "tool.get_keyframes": "Get all keyframes for a specific effect property on a clip",
614
+ "tool.get_keyframes.param.effect_name": "Display name of the effect",
615
+ "tool.get_keyframes.param.node_id": "Node ID of the clip",
616
+ "tool.get_keyframes.param.property_name": "Display name of the property",
617
+ "tool.get_linked_items": "Get all clips in the sequence that are linked to the same source as a given clip",
618
+ "tool.get_linked_items.param.node_id": "Node ID of the clip",
619
+ "tool.get_loudness_info": "Get loudness information for an audio clip including current level and duration.",
620
+ "tool.get_loudness_info.param.clip_index": "Clip index on the track (0-based)",
621
+ "tool.get_loudness_info.param.track_index": "Audio track index (0-based)",
622
+ "tool.get_media_cache_settings": "Get media cache location and size settings.",
623
+ "tool.get_memory_settings": "Get current memory usage settings for Premiere Pro.",
624
+ "tool.get_metadata": "Get metadata for a project item",
625
+ "tool.get_metadata.param.item_id": "Node ID or name of the project item",
626
+ "tool.get_mogrt_component": "Get MOGRT (Motion Graphics Template) component parameters from a clip",
627
+ "tool.get_mogrt_component.param.node_id": "Node ID of the MOGRT clip on the timeline",
628
+ "tool.get_multicam_angles": "Get the list of available camera angles for a multicam clip on the timeline.",
629
+ "tool.get_multicam_angles.param.clip_index": "Clip index on the track (0-based)",
630
+ "tool.get_multicam_angles.param.track_index": "Video track index containing the multicam clip (0-based)",
631
+ "tool.get_next_edit_point": "Find the next or previous edit point (clip boundary) from the playhead position.",
632
+ "tool.get_next_edit_point.param.direction": "Direction to search (default: next)",
633
+ "tool.get_next_edit_point.param.track_type": "Track type to check (default: both)",
634
+ "tool.get_offline_media": "Find all offline/missing media in the project with their expected file paths. Essential for diagnosing broken links.",
635
+ "tool.get_panning_keyframes": "Get all panning keyframes for an audio clip.",
636
+ "tool.get_panning_keyframes.param.clip_index": "Clip index on the track (0-based)",
637
+ "tool.get_panning_keyframes.param.track_index": "Audio track index (0-based)",
638
+ "tool.get_playback_resolution": "Get the current playback resolution setting (Full, 1/2, 1/4, 1/8).",
639
+ "tool.get_playhead_position": "Get the current playhead (CTI) position in the active sequence",
640
+ "tool.get_premiere_state": "Get a comprehensive snapshot of the current Premiere Pro state: project info, active sequence, playhead position, selected clips, and available sequences. The best first call to understand the current context.",
641
+ "tool.get_project_info": "Get information about the currently open Premiere Pro project",
642
+ "tool.get_project_item_info": "Get detailed information about a project item (media file in the project panel): media path, resolution, duration, frame rate, codec info, metadata, color label, offline status, in/out points, and proxy status.",
643
+ "tool.get_project_item_info.param.item_id": "Node ID or name of the project item",
644
+ "tool.get_project_panel_metadata": "Get the current project panel metadata/column configuration as XML",
645
+ "tool.get_project_scratch_disks": "Get the current scratch disk paths for the project.",
646
+ "tool.get_project_settings": "Get project-level settings including scratch disk paths and general project configuration.",
647
+ "tool.get_proxy_path": "Get the file path of the proxy attached to a project item.",
648
+ "tool.get_proxy_path.param.project_item_index": "Project item index (0-based, from root item children)",
649
+ "tool.get_qe_clip_info": "Get QE DOM information about a clip, including properties not available through the standard API.",
650
+ "tool.get_qe_clip_info.param.clip_index": "Clip index on the track (0-based)",
651
+ "tool.get_qe_clip_info.param.track_index": "Track index (0-based)",
652
+ "tool.get_qe_clip_info.param.track_type": "Track type",
653
+ "tool.get_render_queue_status": "Get the current status of the Adobe Media Encoder render queue",
654
+ "tool.get_renderer_info": "Get information about the current video renderer (Software, Mercury GPU Acceleration, etc.).",
655
+ "tool.get_selected_clips": "Get the currently selected clips in the active sequence",
656
+ "tool.get_sequence_color_space": "Get the color space setting for the active sequence.",
657
+ "tool.get_sequence_count": "Get the total number of sequences in the project.",
658
+ "tool.get_sequence_duration": "Get the total duration of the active sequence in seconds and as timecode.",
659
+ "tool.get_sequence_in_out_points": "Get the current sequence in and out points",
660
+ "tool.get_sequence_loudness": "Get loudness information for the entire active sequence including all audio tracks.",
661
+ "tool.get_sequence_markers_by_type": "Get all markers of a specific type (comment, chapter, web link, etc.) from a sequence.",
662
+ "tool.get_sequence_markers_by_type.param.marker_type": "Type of marker to filter",
663
+ "tool.get_sequence_markers_by_type.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
664
+ "tool.get_sequence_settings": "Get detailed settings for a specific sequence including frame size, frame rate, sample rate, codec, and color space.",
665
+ "tool.get_sequence_settings.param.sequence_index": "Sequence index (0-based). Default: active sequence (0).",
666
+ "tool.get_sequence_structure": "Get a complete structural overview of the active sequence: all tracks, all clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.",
667
+ "tool.get_sequence_structure.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
668
+ "tool.get_source_monitor_info": "Get information about the clip currently loaded in the Source Monitor.",
669
+ "tool.get_source_monitor_position": "Get the current time indicator position in the Source Monitor",
670
+ "tool.get_stabilization_status": "Check if Warp Stabilizer is applied to a clip and get its status.",
671
+ "tool.get_stabilization_status.param.clip_index": "Clip index on the track (0-based)",
672
+ "tool.get_stabilization_status.param.track_index": "Video track index (0-based)",
673
+ "tool.get_system_info": "Get system information including OS, available RAM, GPU, and Premiere Pro version details.",
674
+ "tool.get_target_tracks": "Get which tracks are currently targeted for editing.",
675
+ "tool.get_timeline_gaps": "Find all gaps (empty spaces) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.",
676
+ "tool.get_timeline_gaps.param.min_gap_seconds": "Minimum gap duration in seconds to report (default: 0.04 = ~1 frame at 24fps)",
677
+ "tool.get_timeline_gaps.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
678
+ "tool.get_timeline_gaps.param.track_type": "Which track type to analyze (default: both)",
679
+ "tool.get_timeline_settings": "Get timeline display settings including snapping, zoom level, and other options.",
680
+ "tool.get_timeline_summary": "Get a human-readable summary of the timeline: total duration, clip count per track, total gaps, coverage percentage, used media files, effect usage, and marker overview. Great for a quick understanding of sequence state.",
681
+ "tool.get_timeline_summary.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
682
+ "tool.get_total_clip_count": "Get the total number of clips across all tracks in the active sequence.",
683
+ "tool.get_track_info": "Get detailed information about a specific track: name, clip count, muted, locked, targeted, and list of all clips.",
684
+ "tool.get_track_info.param.track_index": "Track index (0-based)",
685
+ "tool.get_track_info.param.track_type": "Track type",
686
+ "tool.get_track_output": "Get the output channel assignment for an audio track.",
687
+ "tool.get_track_output.param.track_index": "Audio track index (0-based)",
688
+ "tool.get_transform_properties": "Get all transform properties (position, scale, rotation, anchor point, opacity) for a video clip.",
689
+ "tool.get_transform_properties.param.clip_index": "Clip index on the track (0-based)",
690
+ "tool.get_transform_properties.param.track_index": "Video track index (0-based)",
691
+ "tool.get_unused_media": "Find all project items that are NOT used in any sequence. Useful for cleaning up projects.",
692
+ "tool.get_used_media_report": "Get a report of all media files used in a sequence: which source files are used, how many times each appears, on which tracks, and whether any sources are offline.",
693
+ "tool.get_used_media_report.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
694
+ "tool.get_value_at_time": "Get the interpolated value of an effect property at a specific time",
695
+ "tool.get_value_at_time.param.effect_name": "Display name of the effect",
696
+ "tool.get_value_at_time.param.node_id": "Node ID of the clip",
697
+ "tool.get_value_at_time.param.property_name": "Display name of the property",
698
+ "tool.get_value_at_time.param.time_seconds": "Time in seconds to query the value at",
699
+ "tool.get_version_info": "Get Premiere Pro version and build information.",
700
+ "tool.get_volume_keyframes": "Get all volume keyframes for an audio clip.",
701
+ "tool.get_volume_keyframes.param.clip_index": "Clip index on the track (0-based)",
702
+ "tool.get_volume_keyframes.param.track_index": "Audio track index (0-based)",
703
+ "tool.get_work_area": "Get the current work area in and out points",
704
+ "tool.get_workspaces": "List all available workspace layouts in Premiere Pro",
705
+ "tool.get_xmp_metadata": "Get the raw XMP metadata for a project item (includes EXIF, IPTC, Dublin Core, etc.)",
706
+ "tool.get_xmp_metadata.param.item_id": "Node ID or name of the project item",
707
+ "tool.has_proxy": "Check if a project item has a proxy attached.",
708
+ "tool.has_proxy.param.project_item_index": "Project item index (0-based, from root item children)",
709
+ "tool.import_ae_comps": "Import After Effects compositions from an .aep file",
710
+ "tool.import_ae_comps.param.ae_project_path": "Full path to the .aep file",
711
+ "tool.import_ae_comps.param.comp_names": "Array of composition names to import. If omitted, imports all comps.",
712
+ "tool.import_ae_comps.param.target_bin": "Target bin name or node ID (optional)",
713
+ "tool.import_fcp_xml": "Import a Final Cut Pro XML file into the current project",
714
+ "tool.import_fcp_xml.param.path": "Full path to the FCP XML file",
715
+ "tool.import_folder": "Import an entire folder of media into the project",
716
+ "tool.import_folder.param.folder_path": "Path to the folder to import",
717
+ "tool.import_image_sequence": "Import a numbered image sequence as a single video clip.",
718
+ "tool.import_image_sequence.param.first_file_path": "Full path to the first image in the sequence (e.g., /path/to/frame_001.png)",
719
+ "tool.import_image_sequence.param.target_bin": "Target bin name to import into (optional, imports to root if omitted)",
720
+ "tool.import_markers_from_csv": "Import sequence markers from a CSV file.",
721
+ "tool.import_markers_from_csv.param.csv_path": "Full path to the CSV file containing markers",
722
+ "tool.import_media": "Import one or more media files into the Premiere Pro project panel.\n\nPreconditions: A project must be open. File paths must be absolute paths accessible from the machine running Premiere Pro (not the MCP server).\n\nAfter import, use list_project_items to get the node IDs of the imported clips, which are needed for add_to_timeline and other operations.\n\nSupported formats: Video (MP4, MOV, MXF, AVI, R3D, BRAW), Audio (WAV, AIFF, MP3, AAC), Images (JPG, PNG, TIFF, PSD), and all other formats Premiere Pro supports.\n\nParameters:\n- file_paths: Array of absolute file paths to import. Use forward slashes on macOS, backslashes on Windows.\n- target_bin: Optional bin name to import into (organize media). If omitted, imports to project root.\n- suppress_ui: Whether to skip import dialogs (default: true — recommended for automation).\n\nExample: import_media({ file_paths: [\"C:\\\\Media\\\\interview.mp4\", \"C:\\\\Media\\\\broll.mp4\"] })\nExample: import_media({ file_paths: [\"/Users/me/footage/clip.mov\"], target_bin: \"B-Roll\" })",
723
+ "tool.import_media.param.file_paths": "Array of file paths to import",
724
+ "tool.import_media.param.suppress_ui": "Suppress import dialogs (default: true)",
725
+ "tool.import_media.param.target_bin": "Optional bin name or node ID to import into. Imports to root if omitted.",
726
+ "tool.import_mogrt": "Import a Motion Graphics Template (.mogrt) file and add it to the timeline",
727
+ "tool.import_mogrt.param.duration_seconds": "Duration in seconds (default: 5)",
728
+ "tool.import_mogrt.param.mogrt_path": "Full path to the .mogrt file",
729
+ "tool.import_mogrt.param.start_seconds": "Start time in seconds (default: 0)",
730
+ "tool.import_mogrt.param.track_index": "Video track index (default: 0)",
731
+ "tool.import_mogrt_from_library": "Import a MOGRT from an Adobe Library by name",
732
+ "tool.import_mogrt_from_library.param.mogrt_name": "Name of the MOGRT in the library",
733
+ "tool.import_mogrt_from_library.param.start_seconds": "Start time in seconds (default: 0)",
734
+ "tool.import_mogrt_from_library.param.track_index": "Video track index (default: 0)",
735
+ "tool.import_sequences": "Import sequences from another Premiere Pro project file",
736
+ "tool.import_sequences.param.project_path": "Full path to the source .prproj file",
737
+ "tool.import_sequences.param.sequence_ids": "Array of sequence IDs to import from the source project. If omitted, all sequences are imported.",
738
+ "tool.insert_from_source": "Insert the clip from the Source Monitor at the playhead position (insert edit — shifts existing clips).",
739
+ "tool.insert_from_source.param.audio_track_index": "Target audio track index (default: 0)",
740
+ "tool.insert_from_source.param.video_track_index": "Target video track index (default: 0)",
741
+ "tool.inspect_dom_object": "Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging.\n\nExamples:\n- \"app.project\" → project properties\n- \"app.project.activeSequence\" → sequence properties\n- \"app.project.activeSequence.videoTracks[0].clips[0]\" → first clip on V1\n- \"app.project.activeSequence.videoTracks[0].clips[0].components[0]\" → first component of a clip",
742
+ "tool.inspect_dom_object.param.max_depth": "Max depth for nested inspection (default: 1, max: 3)",
743
+ "tool.inspect_dom_object.param.object_path": "Dot-path to the DOM object to inspect (e.g., 'app.project.activeSequence')",
744
+ "tool.invert_selection": "Invert the current clip selection in the active sequence (selected become deselected and vice versa).",
745
+ "tool.is_work_area_enabled": "Check whether the work area bar is enabled on the active sequence",
746
+ "tool.launch_ame": "Launch Adobe Media Encoder application.",
747
+ "tool.lift_selection": "Lift (remove without closing gap) the content between sequence in/out points or selected clips.",
748
+ "tool.link_selection": "Link the currently selected video and audio clips in the active sequence",
749
+ "tool.list_available_audio_effects": "List all available audio effects in Premiere Pro.",
750
+ "tool.list_available_audio_transitions": "List all available audio transitions in Premiere Pro.",
751
+ "tool.list_available_effects": "List all available video effects in Premiere Pro.",
752
+ "tool.list_available_transitions": "List all available video transitions in Premiere Pro.",
753
+ "tool.list_clip_effects": "List all effects/components on a clip with their properties and current values. Essential for debugging effect issues.",
754
+ "tool.list_clip_effects.param.node_id": "Node ID of the clip to inspect",
755
+ "tool.list_markers": "List all markers on the active sequence or a specific clip",
756
+ "tool.list_markers.param.node_id": "Optional clip node ID to list clip markers instead of sequence markers",
757
+ "tool.list_project_items": "List all items in the project panel (clips, bins, sequences)",
758
+ "tool.list_project_items.param.bin_path": "Optional bin path to list items from (e.g., 'Footage/Raw'). Lists root items if omitted.",
759
+ "tool.list_sequence_tracks": "List all tracks (video and audio) in a sequence",
760
+ "tool.list_sequence_tracks.param.sequence_id": "Sequence ID or name. Uses active sequence if omitted.",
761
+ "tool.list_sequences": "List all sequences in the project",
762
+ "tool.lock_audio_track": "Lock or unlock an audio track to prevent accidental edits.",
763
+ "tool.lock_audio_track.param.locked": "True to lock, false to unlock",
764
+ "tool.lock_audio_track.param.track_index": "Audio track index (0-based)",
765
+ "tool.lock_track": "Lock or unlock a video track",
766
+ "tool.lock_track.param.locked": "True to lock, false to unlock",
767
+ "tool.lock_track.param.track_index": "Video track index (0-based)",
768
+ "tool.lock_video_track": "Lock or unlock a video track to prevent accidental edits.",
769
+ "tool.lock_video_track.param.locked": "True to lock, false to unlock",
770
+ "tool.lock_video_track.param.track_index": "Video track index (0-based)",
771
+ "tool.lumetri_apply_lut": "Apply a LUT (.cube or .3dl file) to a clip via Lumetri Color. The LUT file must be accessible on disk.",
772
+ "tool.lumetri_apply_lut.param.clip_index": "Clip index on the track (0-based)",
773
+ "tool.lumetri_apply_lut.param.lut_path": "Full path to the LUT file (.cube or .3dl)",
774
+ "tool.lumetri_apply_lut.param.track_index": "Video track index (0-based)",
775
+ "tool.lumetri_auto_color": "Apply automatic color correction to a clip using Lumetri Color. Sets reasonable default values for exposure and white balance.",
776
+ "tool.lumetri_auto_color.param.clip_index": "Clip index on the track (0-based)",
777
+ "tool.lumetri_auto_color.param.track_index": "Video track index (0-based)",
778
+ "tool.lumetri_auto_white_balance": "Apply automatic white balance to a clip using Lumetri Color. Analyzes the clip and adjusts temperature and tint.",
779
+ "tool.lumetri_auto_white_balance.param.clip_index": "Clip index on the track (0-based)",
780
+ "tool.lumetri_auto_white_balance.param.track_index": "Video track index (0-based)",
781
+ "tool.lumetri_get_all": "Get all Lumetri Color parameter values for a clip. Returns exposure, contrast, highlights, shadows, whites, blacks, temperature, tint, saturation, vibrance, vignette, and all other parameters.",
782
+ "tool.lumetri_get_all.param.clip_index": "Clip index on the track (0-based)",
783
+ "tool.lumetri_get_all.param.track_index": "Video track index (0-based)",
784
+ "tool.lumetri_remove_lut": "Remove the applied LUT from a clip's Lumetri Color effect.",
785
+ "tool.lumetri_remove_lut.param.clip_index": "Clip index on the track (0-based)",
786
+ "tool.lumetri_remove_lut.param.track_index": "Video track index (0-based)",
787
+ "tool.lumetri_reset": "Reset all Lumetri Color parameters to their default (neutral) values for a clip.",
788
+ "tool.lumetri_reset.param.clip_index": "Clip index on the track (0-based)",
789
+ "tool.lumetri_reset.param.track_index": "Video track index (0-based)",
790
+ "tool.lumetri_set_blacks": "Set Lumetri Color blacks for a clip. Range: -100 to +100. Negative values crush the blacks.",
791
+ "tool.lumetri_set_blacks.param.clip_index": "Clip index on the track (0-based)",
792
+ "tool.lumetri_set_blacks.param.track_index": "Video track index (0-based)",
793
+ "tool.lumetri_set_blacks.param.value": "Blacks value from -100 to +100",
794
+ "tool.lumetri_set_contrast": "Set Lumetri Color contrast for a clip. Range: -100 to +100. 0 = no change.",
795
+ "tool.lumetri_set_contrast.param.clip_index": "Clip index on the track (0-based)",
796
+ "tool.lumetri_set_contrast.param.track_index": "Video track index (0-based)",
797
+ "tool.lumetri_set_contrast.param.value": "Contrast value from -100 to +100",
798
+ "tool.lumetri_set_curve_point": "Set a point on the RGB/Luma tone curve for Lumetri Color. Channel: 'luma', 'red', 'green', or 'blue'. Input/output values are 0-255.",
799
+ "tool.lumetri_set_curve_point.param.channel": "Curve channel: 'luma', 'red', 'green', or 'blue'",
800
+ "tool.lumetri_set_curve_point.param.clip_index": "Clip index on the track (0-based)",
801
+ "tool.lumetri_set_curve_point.param.input_value": "Input (x-axis) value from 0 to 255",
802
+ "tool.lumetri_set_curve_point.param.output_value": "Output (y-axis) value from 0 to 255",
803
+ "tool.lumetri_set_curve_point.param.track_index": "Video track index (0-based)",
804
+ "tool.lumetri_set_exposure": "Set Lumetri Color exposure for a clip. Range: -4.0 (very dark) to +4.0 (very bright). 0 = no change.",
805
+ "tool.lumetri_set_exposure.param.clip_index": "Clip index on the track (0-based)",
806
+ "tool.lumetri_set_exposure.param.track_index": "Video track index (0-based)",
807
+ "tool.lumetri_set_exposure.param.value": "Exposure value from -4.0 to +4.0",
808
+ "tool.lumetri_set_faded_film": "Set Lumetri Color faded film amount for a clip. Range: 0 to 100. Creates a filmic fade/matte look.",
809
+ "tool.lumetri_set_faded_film.param.clip_index": "Clip index on the track (0-based)",
810
+ "tool.lumetri_set_faded_film.param.track_index": "Video track index (0-based)",
811
+ "tool.lumetri_set_faded_film.param.value": "Faded film amount from 0 to 100",
812
+ "tool.lumetri_set_highlight_color": "Set the highlight color wheel in Lumetri Color. Adjusts hue, saturation, and brightness of highlights.",
813
+ "tool.lumetri_set_highlight_color.param.brightness": "Brightness adjustment (-100 to +100)",
814
+ "tool.lumetri_set_highlight_color.param.clip_index": "Clip index on the track (0-based)",
815
+ "tool.lumetri_set_highlight_color.param.hue": "Hue angle in degrees (0-360)",
816
+ "tool.lumetri_set_highlight_color.param.saturation": "Saturation amount (0-100)",
817
+ "tool.lumetri_set_highlight_color.param.track_index": "Video track index (0-based)",
818
+ "tool.lumetri_set_highlights": "Set Lumetri Color highlights for a clip. Range: -100 to +100. Positive values recover highlight detail.",
819
+ "tool.lumetri_set_highlights.param.clip_index": "Clip index on the track (0-based)",
820
+ "tool.lumetri_set_highlights.param.track_index": "Video track index (0-based)",
821
+ "tool.lumetri_set_highlights.param.value": "Highlights value from -100 to +100",
822
+ "tool.lumetri_set_midtone_color": "Set the midtone color wheel in Lumetri Color. Adjusts hue, saturation, and brightness of midtones.",
823
+ "tool.lumetri_set_midtone_color.param.brightness": "Brightness adjustment (-100 to +100)",
824
+ "tool.lumetri_set_midtone_color.param.clip_index": "Clip index on the track (0-based)",
825
+ "tool.lumetri_set_midtone_color.param.hue": "Hue angle in degrees (0-360)",
826
+ "tool.lumetri_set_midtone_color.param.saturation": "Saturation amount (0-100)",
827
+ "tool.lumetri_set_midtone_color.param.track_index": "Video track index (0-based)",
828
+ "tool.lumetri_set_saturation": "Set Lumetri Color saturation for a clip. Range: 0 (black and white) to 200 (double saturation). 100 = no change.",
829
+ "tool.lumetri_set_saturation.param.clip_index": "Clip index on the track (0-based)",
830
+ "tool.lumetri_set_saturation.param.track_index": "Video track index (0-based)",
831
+ "tool.lumetri_set_saturation.param.value": "Saturation value from 0 to 200. 100 = original.",
832
+ "tool.lumetri_set_shadow_color": "Set the shadow color wheel in Lumetri Color. Adjusts hue, saturation, and brightness of shadows.",
833
+ "tool.lumetri_set_shadow_color.param.brightness": "Brightness adjustment (-100 to +100)",
834
+ "tool.lumetri_set_shadow_color.param.clip_index": "Clip index on the track (0-based)",
835
+ "tool.lumetri_set_shadow_color.param.hue": "Hue angle in degrees (0-360)",
836
+ "tool.lumetri_set_shadow_color.param.saturation": "Saturation amount (0-100)",
837
+ "tool.lumetri_set_shadow_color.param.track_index": "Video track index (0-based)",
838
+ "tool.lumetri_set_shadows": "Set Lumetri Color shadows for a clip. Range: -100 to +100. Positive values lift shadows.",
839
+ "tool.lumetri_set_shadows.param.clip_index": "Clip index on the track (0-based)",
840
+ "tool.lumetri_set_shadows.param.track_index": "Video track index (0-based)",
841
+ "tool.lumetri_set_shadows.param.value": "Shadows value from -100 to +100",
842
+ "tool.lumetri_set_sharpen": "Set Lumetri Color sharpening for a clip. Range: 0 to 200. 0 = no sharpening.",
843
+ "tool.lumetri_set_sharpen.param.clip_index": "Clip index on the track (0-based)",
844
+ "tool.lumetri_set_sharpen.param.track_index": "Video track index (0-based)",
845
+ "tool.lumetri_set_sharpen.param.value": "Sharpen amount from 0 to 200",
846
+ "tool.lumetri_set_temperature": "Set Lumetri Color white balance temperature for a clip. Negative values are cooler (blue), positive values are warmer (orange).",
847
+ "tool.lumetri_set_temperature.param.clip_index": "Clip index on the track (0-based)",
848
+ "tool.lumetri_set_temperature.param.track_index": "Video track index (0-based)",
849
+ "tool.lumetri_set_temperature.param.value": "Temperature value (negative = cool/blue, positive = warm/orange)",
850
+ "tool.lumetri_set_tint": "Set Lumetri Color white balance tint for a clip. Negative values are green, positive values are magenta.",
851
+ "tool.lumetri_set_tint.param.clip_index": "Clip index on the track (0-based)",
852
+ "tool.lumetri_set_tint.param.track_index": "Video track index (0-based)",
853
+ "tool.lumetri_set_tint.param.value": "Tint value (negative = green, positive = magenta)",
854
+ "tool.lumetri_set_vibrance": "Set Lumetri Color vibrance for a clip. Range: -100 to +100. Vibrance selectively boosts less-saturated colors.",
855
+ "tool.lumetri_set_vibrance.param.clip_index": "Clip index on the track (0-based)",
856
+ "tool.lumetri_set_vibrance.param.track_index": "Video track index (0-based)",
857
+ "tool.lumetri_set_vibrance.param.value": "Vibrance value from -100 to +100",
858
+ "tool.lumetri_set_vignette_amount": "Set Lumetri Color vignette amount. Range: -5 (dark vignette) to +5 (light vignette). 0 = no vignette.",
859
+ "tool.lumetri_set_vignette_amount.param.clip_index": "Clip index on the track (0-based)",
860
+ "tool.lumetri_set_vignette_amount.param.track_index": "Video track index (0-based)",
861
+ "tool.lumetri_set_vignette_amount.param.value": "Vignette amount from -5 to +5",
862
+ "tool.lumetri_set_vignette_feather": "Set Lumetri Color vignette feather (softness). Range: 0 to 100. Higher values create a softer vignette edge.",
863
+ "tool.lumetri_set_vignette_feather.param.clip_index": "Clip index on the track (0-based)",
864
+ "tool.lumetri_set_vignette_feather.param.track_index": "Video track index (0-based)",
865
+ "tool.lumetri_set_vignette_feather.param.value": "Vignette feather from 0 to 100",
866
+ "tool.lumetri_set_vignette_midpoint": "Set Lumetri Color vignette midpoint (size). Range: 0 to 100. Higher values move the vignette edge outward (smaller vignette).",
867
+ "tool.lumetri_set_vignette_midpoint.param.clip_index": "Clip index on the track (0-based)",
868
+ "tool.lumetri_set_vignette_midpoint.param.track_index": "Video track index (0-based)",
869
+ "tool.lumetri_set_vignette_midpoint.param.value": "Vignette midpoint from 0 to 100",
870
+ "tool.lumetri_set_vignette_roundness": "Set Lumetri Color vignette roundness. Range: -100 (rectangular) to +100 (circular). 0 = square corners.",
871
+ "tool.lumetri_set_vignette_roundness.param.clip_index": "Clip index on the track (0-based)",
872
+ "tool.lumetri_set_vignette_roundness.param.track_index": "Video track index (0-based)",
873
+ "tool.lumetri_set_vignette_roundness.param.value": "Vignette roundness from -100 to +100",
874
+ "tool.lumetri_set_whites": "Set Lumetri Color whites for a clip. Range: -100 to +100. Affects the brightest whites.",
875
+ "tool.lumetri_set_whites.param.clip_index": "Clip index on the track (0-based)",
876
+ "tool.lumetri_set_whites.param.track_index": "Video track index (0-based)",
877
+ "tool.lumetri_set_whites.param.value": "Whites value from -100 to +100",
878
+ "tool.manage_proxies": "Create or attach proxies for a project item",
879
+ "tool.manage_proxies.param.action": "Action to perform on proxies",
880
+ "tool.manage_proxies.param.item_id": "Node ID or name of the project item",
881
+ "tool.manage_proxies.param.proxy_path": "Path to proxy file (required for 'attach' action)",
882
+ "tool.match_frame": "Get source media info for the frame at the current playhead on a specific track. Useful for match frame operations.",
883
+ "tool.match_frame.param.track_index": "Track index (default: 0)",
884
+ "tool.match_frame.param.track_type": "Track type (default: video)",
885
+ "tool.move_clip": "Move a clip to a new timeline position, optionally changing its track.\n\nPreconditions: An active sequence must exist and the clip's node_id must be valid (get node IDs from get_active_sequence or list_sequence_tracks).\n\nThe clip moves to the exact start time specified in seconds. If new_track_index is provided, the clip is also moved to that track. The audio/video link is maintained during the move.\n\nNote: This uses clip.moveToTime() which is the correct ExtendScript API — clip.start is read-only and cannot be assigned directly.\n\nExample: move_clip({ node_id: \"abc123\", new_start_seconds: 45.5 })\nExample: move_clip({ node_id: \"abc123\", new_start_seconds: 10.0, new_track_index: 1 })",
886
+ "tool.move_clip.param.new_start_seconds": "New start time in seconds",
887
+ "tool.move_clip.param.new_track_index": "Optional new track index to move the clip to",
888
+ "tool.move_clip.param.node_id": "Node ID of the clip to move",
889
+ "tool.move_clip_to_track": "Move a clip to a different track. Uses QE DOM.",
890
+ "tool.move_clip_to_track.param.node_id": "Node ID of the clip",
891
+ "tool.move_clip_to_track.param.target_track_index": "Target track index (0-based)",
892
+ "tool.move_item_to_bin": "Move a project item to a different bin",
893
+ "tool.move_item_to_bin.param.item_id": "Node ID or name of the item to move",
894
+ "tool.move_item_to_bin.param.target_bin": "Name or node ID of the target bin",
895
+ "tool.move_items_to_bin": "Move multiple project items to a target bin at once.",
896
+ "tool.move_items_to_bin.param.item_ids": "Array of node IDs or names of items to move",
897
+ "tool.move_items_to_bin.param.target_bin": "Name or node ID of the target bin",
898
+ "tool.move_playhead_to_edit": "Move the playhead to the next or previous edit point.",
899
+ "tool.move_playhead_to_edit.param.direction": "Direction (default: next)",
900
+ "tool.multiple_undo": "Undo multiple steps at once.",
901
+ "tool.multiple_undo.param.count": "Number of undo steps (default: 1)",
902
+ "tool.mute_all_audio_tracks": "Mute all audio tracks in the active sequence.",
903
+ "tool.mute_audio_track": "Mute or unmute an audio track.",
904
+ "tool.mute_audio_track.param.muted": "True to mute, false to unmute",
905
+ "tool.mute_audio_track.param.track_index": "Audio track index (0-based)",
906
+ "tool.mute_track": "Mute or unmute an audio track",
907
+ "tool.mute_track.param.muted": "True to mute, false to unmute",
908
+ "tool.mute_track.param.track_index": "Audio track index (0-based)",
909
+ "tool.mute_video_track": "Mute or unmute a video track (hide/show its output).",
910
+ "tool.mute_video_track.param.muted": "True to mute (hide), false to unmute (show)",
911
+ "tool.mute_video_track.param.track_index": "Video track index (0-based)",
912
+ "tool.nest_clips": "Nest selected clips into a nested sequence. Select the clips first, then call this tool.",
913
+ "tool.nest_clips.param.name": "Name for the nested sequence",
914
+ "tool.nest_sequence": "Nest the currently selected clips into a new sub-sequence (nested sequence).\n\nThis replaces the selected clips on the timeline with a single clip that contains a new sub-sequence with the original clips. Nesting is useful for:\n- Grouping clips to apply a single effect to all of them\n- Organizing complex timelines\n- Applying motion/transform to a group of clips\n- Creating \"packages\" for reuse\n\nPreconditions:\n1. An active sequence must exist.\n2. Clips must be selected before calling this tool. Use set_clip_selection or select_clips_by_name to select clips first.\n3. At least one clip must be selected.\n\nAfter nesting, the new sub-sequence appears in the project panel and can be opened and edited independently.\n\nExample workflow:\n 1. select_clips_by_name({ names: [\"clip1.mp4\", \"clip2.mp4\"] })\n 2. nest_sequence({ name: \"Intro Package\" })\n\nExample: nest_sequence({ name: \"Color Grade Group\" })",
915
+ "tool.nest_sequence.param.name": "Name for the new nested sub-sequence",
916
+ "tool.normalize_all_audio": "Normalize all audio clips on all tracks to a target dB level.",
917
+ "tool.normalize_all_audio.param.target_db": "Target normalization level in dB (e.g. -6 for -6dBFS). Default: -6.",
918
+ "tool.open_in_source": "Open a project item in the Source Monitor for preview and trimming.",
919
+ "tool.open_in_source.param.item_id": "Node ID or name of the project item to open",
920
+ "tool.open_project": "Open a Premiere Pro project file",
921
+ "tool.open_project.param.path": "Full file path to the .prproj file",
922
+ "tool.overwrite_clip": "Overwrite a project item onto the timeline (replaces existing clips at the insertion point)",
923
+ "tool.overwrite_clip.param.audio_track_index": "Audio track index (0-based, default: 0)",
924
+ "tool.overwrite_clip.param.item_id": "Node ID or name of the project item to add",
925
+ "tool.overwrite_clip.param.start_seconds": "Start time in seconds on the timeline (default: 0)",
926
+ "tool.overwrite_clip.param.track_index": "Video track index (0-based, default: 0)",
927
+ "tool.overwrite_from_source": "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips).",
928
+ "tool.overwrite_from_source.param.audio_track_index": "Target audio track index (default: 0)",
929
+ "tool.overwrite_from_source.param.video_track_index": "Target video track index (default: 0)",
930
+ "tool.paste_color_grade": "Paste the previously copied Lumetri Color grade to a destination clip. Call copy_color_grade first.",
931
+ "tool.paste_color_grade.param.clip_index": "Destination clip index on the track (0-based)",
932
+ "tool.paste_color_grade.param.track_index": "Destination video track index (0-based)",
933
+ "tool.ping": "Health check — verify the CEP plugin is running and connected to Premiere Pro. Call this before other tools to confirm connectivity.",
934
+ "tool.play_source_monitor": "Start playback of the clip in the Source Monitor",
935
+ "tool.play_source_monitor.param.speed": "Playback speed (1.0 = normal, 2.0 = 2x, -1.0 = reverse). Default: 1.0",
936
+ "tool.play_timeline": "Start playback of the active sequence timeline. Uses QE DOM.",
937
+ "tool.prepare_voiceover_track": "Prepare an audio track for voiceover recording by muting all other tracks and targeting this one.",
938
+ "tool.prepare_voiceover_track.param.track_index": "Audio track index to set up for voiceover (0-based)",
939
+ "tool.razor_all_tracks": "Razor (split) all clips at the playhead position across all tracks, or at a specific time.",
940
+ "tool.razor_all_tracks.param.time_seconds": "Time to razor at in seconds (uses playhead position if omitted)",
941
+ "tool.razor_all_tracks.param.track_type": "Which track types to razor (default: both)",
942
+ "tool.redo": "Redo the last undone action in Premiere Pro.",
943
+ "tool.refresh_media": "Refresh a project item to pick up changes to the source file",
944
+ "tool.refresh_media.param.item_id": "Node ID or name of the item to refresh",
945
+ "tool.relink_media": "Relink an offline media item to a new file path",
946
+ "tool.relink_media.param.item_id": "Node ID or name of the item to relink",
947
+ "tool.relink_media.param.new_path": "New file path for the media",
948
+ "tool.remove_all_audio_keyframes": "Remove all volume and panning keyframes from an audio clip, returning it to static values.",
949
+ "tool.remove_all_audio_keyframes.param.clip_index": "Clip index on the track (0-based)",
950
+ "tool.remove_all_audio_keyframes.param.track_index": "Audio track index (0-based)",
951
+ "tool.remove_all_effects": "Remove all applied effects from a clip (keeps intrinsic Motion and Opacity).",
952
+ "tool.remove_all_effects.param.clip_index": "Clip index on the track (0-based)",
953
+ "tool.remove_all_effects.param.track_index": "Track index (0-based)",
954
+ "tool.remove_all_effects.param.track_type": "Track type: 'video' or 'audio'",
955
+ "tool.remove_effect": "Remove an effect from a clip by its index or name",
956
+ "tool.remove_effect.param.effect_index": "Index of the effect to remove (0-based). Use get_clip_properties to see effects list.",
957
+ "tool.remove_effect.param.effect_name": "Name of the effect to remove (alternative to effect_index)",
958
+ "tool.remove_effect.param.node_id": "Node ID of the clip",
959
+ "tool.remove_effect_by_name": "Remove all instances of a specific effect from a clip by display name.",
960
+ "tool.remove_effect_by_name.param.effect_name": "Display name of the effect to remove",
961
+ "tool.remove_effect_by_name.param.node_id": "Node ID of the clip",
962
+ "tool.remove_from_timeline": "Remove a clip from the timeline",
963
+ "tool.remove_from_timeline.param.node_id": "Node ID of the clip to remove",
964
+ "tool.remove_from_timeline.param.ripple": "Whether to ripple delete (close the gap). Default: false",
965
+ "tool.remove_keyframe": "Remove a keyframe at a specific time from an effect property",
966
+ "tool.remove_keyframe.param.effect_name": "Display name of the effect",
967
+ "tool.remove_keyframe.param.node_id": "Node ID of the clip",
968
+ "tool.remove_keyframe.param.property_name": "Display name of the property",
969
+ "tool.remove_keyframe.param.time_seconds": "Time in seconds of the keyframe to remove",
970
+ "tool.remove_keyframe_range": "Remove all keyframes in a time range from an effect property",
971
+ "tool.remove_keyframe_range.param.effect_name": "Display name of the effect",
972
+ "tool.remove_keyframe_range.param.end_seconds": "End of the range in seconds",
973
+ "tool.remove_keyframe_range.param.node_id": "Node ID of the clip",
974
+ "tool.remove_keyframe_range.param.property_name": "Display name of the property",
975
+ "tool.remove_keyframe_range.param.start_seconds": "Start of the range in seconds",
976
+ "tool.remove_pip": "Remove PIP effect by resetting the clip's position and scale back to full frame.",
977
+ "tool.remove_pip.param.clip_index": "Clip index on the track (0-based)",
978
+ "tool.remove_pip.param.track_index": "Video track index (0-based)",
979
+ "tool.remove_selected_clips": "Remove all currently selected clips from the timeline.",
980
+ "tool.remove_selected_clips.param.ripple": "If true, close the gap after removing (ripple delete). Default: false",
981
+ "tool.rename_audio_track": "Rename an audio track in the active sequence.",
982
+ "tool.rename_audio_track.param.name": "New name for the track",
983
+ "tool.rename_audio_track.param.track_index": "Audio track index (0-based)",
984
+ "tool.rename_bin": "Rename a bin (folder) in the project panel",
985
+ "tool.rename_bin.param.bin_id": "Name or node ID of the bin to rename",
986
+ "tool.rename_bin.param.new_name": "New name for the bin",
987
+ "tool.rename_clip": "Rename a clip on the timeline. Uses QE DOM.",
988
+ "tool.rename_clip.param.new_name": "New name for the clip",
989
+ "tool.rename_clip.param.node_id": "Node ID of the clip",
990
+ "tool.rename_project_item": "Rename a project item in the project panel.",
991
+ "tool.rename_project_item.param.item_id": "Node ID or name of the project item",
992
+ "tool.rename_project_item.param.new_name": "New name for the item",
993
+ "tool.rename_track": "Rename a video or audio track.",
994
+ "tool.rename_track.param.name": "New track name",
995
+ "tool.rename_track.param.track_index": "Track index (0-based)",
996
+ "tool.rename_track.param.track_type": "Track type",
997
+ "tool.rename_video_track": "Rename a video track in the active sequence.",
998
+ "tool.rename_video_track.param.name": "New name for the track",
999
+ "tool.rename_video_track.param.track_index": "Video track index (0-based)",
1000
+ "tool.render_sequence_preview": "Render preview files for a range of the sequence. This pre-renders the timeline for smooth playback.",
1001
+ "tool.render_sequence_preview.param.in_seconds": "Start time in seconds. Default: sequence in-point.",
1002
+ "tool.render_sequence_preview.param.out_seconds": "End time in seconds. Default: sequence out-point.",
1003
+ "tool.replace_clip": "Replace a clip on the timeline with a different project item, preserving position and duration",
1004
+ "tool.replace_clip.param.new_item_id": "Node ID or name of the new project item to replace with",
1005
+ "tool.replace_clip.param.node_id": "Node ID of the clip to replace",
1006
+ "tool.replace_clip_media": "Replace the source media of a clip on the timeline with a different project item, keeping the clip's position and duration.",
1007
+ "tool.replace_clip_media.param.clip_node_id": "Node ID of the timeline clip to replace media on",
1008
+ "tool.replace_clip_media.param.new_item_id": "Node ID or name of the new source project item",
1009
+ "tool.reset_color_on_all_clips": "Reset Lumetri Color to default values on all clips on a video track.",
1010
+ "tool.reset_color_on_all_clips.param.track_index": "Video track index (0-based)",
1011
+ "tool.reset_crop": "Reset crop to zero (remove all cropping) from a clip.",
1012
+ "tool.reset_crop.param.clip_index": "Clip index on the track (0-based)",
1013
+ "tool.reset_crop.param.track_index": "Video track index (0-based)",
1014
+ "tool.reset_transform": "Reset all transform properties (position, scale, rotation) to default values for a clip.",
1015
+ "tool.reset_transform.param.clip_index": "Clip index on the track (0-based)",
1016
+ "tool.reset_transform.param.track_index": "Video track index (0-based)",
1017
+ "tool.reverse_clip": "Reverse a clip's playback direction. Uses QE DOM.",
1018
+ "tool.reverse_clip.param.node_id": "Node ID of the clip",
1019
+ "tool.reverse_clip.param.reverse": "True to reverse, false for normal (default: true)",
1020
+ "tool.ripple_delete": "Ripple delete a clip (removes clip and closes the gap). Uses QE DOM.",
1021
+ "tool.ripple_delete.param.node_id": "Node ID of the clip to ripple delete",
1022
+ "tool.ripple_delete_all_gaps": "Ripple delete all gaps on all tracks in the active sequence.",
1023
+ "tool.ripple_delete_gap": "Ripple delete the gap between two time points on a track.",
1024
+ "tool.ripple_delete_gap.param.end_time": "End of the gap in seconds",
1025
+ "tool.ripple_delete_gap.param.start_time": "Start of the gap in seconds",
1026
+ "tool.ripple_delete_gap.param.track_index": "Track index (0-based)",
1027
+ "tool.ripple_delete_gap.param.track_type": "Track type: 'video' or 'audio'",
1028
+ "tool.roll_edit": "Perform a roll edit on a clip (adjusts the edit point between two adjacent clips). Uses QE DOM.",
1029
+ "tool.roll_edit.param.node_id": "Node ID of the clip",
1030
+ "tool.roll_edit.param.offset_seconds": "Offset in seconds (positive = roll right, negative = roll left)",
1031
+ "tool.save_project": "Save the current Premiere Pro project",
1032
+ "tool.save_project_as": "Save the current project to a new location",
1033
+ "tool.save_project_as.param.path": "Full file path to save the project to (e.g., '/Users/me/projects/MyProject.prproj')",
1034
+ "tool.scene_edit_detection": "Perform scene edit detection on the selected clips in the active sequence",
1035
+ "tool.search_project_items": "Search for project items by name, media file extension, offline status, or color label. Returns matching items with full details.",
1036
+ "tool.search_project_items.param.color_label": "Filter by color label index (0-15)",
1037
+ "tool.search_project_items.param.extension": "Filter by file extension (e.g., 'mp4', 'wav', 'png'). Without dot.",
1038
+ "tool.search_project_items.param.item_type": "Filter by item type (default: all)",
1039
+ "tool.search_project_items.param.max_results": "Maximum results to return (default: 100)",
1040
+ "tool.search_project_items.param.offline_only": "If true, only return offline/missing items",
1041
+ "tool.search_project_items.param.query": "Search query (matched against item name, case-insensitive substring match)",
1042
+ "tool.select_all_clips": "Select all clips in the active sequence, or all clips on a specific track.",
1043
+ "tool.select_all_clips.param.track_index": "Specific track index (optional, selects all tracks if omitted)",
1044
+ "tool.select_all_clips.param.track_type": "Track type (default: both)",
1045
+ "tool.select_all_on_track": "Select all clips on a specific track.",
1046
+ "tool.select_all_on_track.param.track_index": "Track index (0-based)",
1047
+ "tool.select_all_on_track.param.track_type": "Track type: 'video' or 'audio'",
1048
+ "tool.select_clips_by_color": "Select all clips whose source project item has a specific color label.",
1049
+ "tool.select_clips_by_color.param.color_index": "Label color index (0=Violet, 1=Iris, 2=Caribbean, 3=Lavender, 4=Cerulean, 5=Forest, 6=Rose, 7=Mango, 8=Purple, 9=Blue, 10=Teal, 11=Magenta, 12=Tan, 13=Green, 14=Brown, 15=Yellow)",
1050
+ "tool.select_clips_by_name": "Select all clips in the active sequence that match a name (substring match). Optionally filter by track type and index.",
1051
+ "tool.select_clips_by_name.param.add_to_selection": "If true, add to existing selection instead of replacing it (default: false)",
1052
+ "tool.select_clips_by_name.param.name": "Clip name to search for (case-insensitive substring match)",
1053
+ "tool.select_clips_by_name.param.track_index": "Specific track index to search (optional, searches all if omitted)",
1054
+ "tool.select_clips_by_name.param.track_type": "Track type to search (default: both)",
1055
+ "tool.select_clips_in_range": "Select all clips that overlap a time range in the active sequence.",
1056
+ "tool.select_clips_in_range.param.end_seconds": "End of selection range in seconds",
1057
+ "tool.select_clips_in_range.param.start_seconds": "Start of selection range in seconds",
1058
+ "tool.select_clips_in_range.param.track_index": "Specific track index (optional)",
1059
+ "tool.select_clips_in_range.param.track_type": "Track type (default: both)",
1060
+ "tool.select_disabled_clips": "Select all disabled clips in the active sequence.",
1061
+ "tool.select_item": "Select a project item in the Project panel",
1062
+ "tool.select_item.param.item_id": "Node ID or name of the project item to select",
1063
+ "tool.set_active_sequence": "Set the active sequence by name or ID",
1064
+ "tool.set_active_sequence.param.sequence_id": "Sequence name or ID to make active",
1065
+ "tool.set_all_tracks_targeted": "Set all tracks targeted or untargeted. Useful before insert/overwrite edits.",
1066
+ "tool.set_all_tracks_targeted.param.targeted": "Whether to target (true) or untarget (false) all tracks",
1067
+ "tool.set_all_tracks_targeted.param.track_type": "Which track type(s) to affect (default: both)",
1068
+ "tool.set_anti_alias_quality": "Set the anti-alias quality on a clip's Motion effect (useful for scaled/rotated clips).",
1069
+ "tool.set_anti_alias_quality.param.enabled": "Enable (true) or disable (false) anti-aliasing",
1070
+ "tool.set_anti_alias_quality.param.node_id": "Node ID of the clip",
1071
+ "tool.set_audio_level": "Set the audio level (volume) of a clip on an audio track by track and clip index.",
1072
+ "tool.set_audio_level.param.clip_index": "Clip index on the track (0-based)",
1073
+ "tool.set_audio_level.param.level_db": "Audio level in dB. Range: -96 to +15. 0 = unity gain.",
1074
+ "tool.set_audio_level.param.track_index": "Audio track index (0-based)",
1075
+ "tool.set_audio_track_target": "Set whether an audio track is targeted for recording or editing operations.",
1076
+ "tool.set_audio_track_target.param.targeted": "True to target this track, false to untarget",
1077
+ "tool.set_audio_track_target.param.track_index": "Audio track index (0-based)",
1078
+ "tool.set_audio_track_volume": "Set the volume level for an entire audio track (track-level fader, not clip-level).",
1079
+ "tool.set_audio_track_volume.param.level_db": "Track volume in dB. Range: -96 to +15. 0 = unity.",
1080
+ "tool.set_audio_track_volume.param.track_index": "Audio track index (0-based)",
1081
+ "tool.set_auto_save_enabled": "Enable or disable auto-save for the project.",
1082
+ "tool.set_auto_save_enabled.param.enabled": "True to enable auto-save, false to disable",
1083
+ "tool.set_auto_save_interval": "Set how frequently Premiere Pro auto-saves the project (in minutes).",
1084
+ "tool.set_auto_save_interval.param.minutes": "Auto-save interval in minutes (1-60). Default: 15.",
1085
+ "tool.set_blend_mode": "Set the blend mode on a video clip. Uses the Opacity effect's Blend Mode property.",
1086
+ "tool.set_blend_mode.param.blend_mode": "Blend mode name",
1087
+ "tool.set_blend_mode.param.node_id": "Node ID of the video clip",
1088
+ "tool.set_clip_anchor_point": "Set the Anchor Point property on a video clip's Motion effect.",
1089
+ "tool.set_clip_anchor_point.param.node_id": "Node ID of the clip",
1090
+ "tool.set_clip_anchor_point.param.x": "Anchor point X in pixels",
1091
+ "tool.set_clip_anchor_point.param.y": "Anchor point Y in pixels",
1092
+ "tool.set_clip_audio_volume": "Set the volume level of an audio clip found by its node ID.",
1093
+ "tool.set_clip_audio_volume.param.level_db": "Audio level in dB. Range: -96 to +15. 0 = unity gain.",
1094
+ "tool.set_clip_audio_volume.param.node_id": "The nodeId of the audio clip (from get_all_clips or get_audio_track_info)",
1095
+ "tool.set_clip_opacity": "Set the opacity of a video clip (0-100).",
1096
+ "tool.set_clip_opacity.param.node_id": "Node ID of the clip",
1097
+ "tool.set_clip_opacity.param.opacity": "Opacity value (0 = transparent, 100 = fully opaque)",
1098
+ "tool.set_clip_pan": "Set the pan (left/right balance) on an audio clip.",
1099
+ "tool.set_clip_pan.param.node_id": "Node ID of the audio clip",
1100
+ "tool.set_clip_pan.param.pan": "Pan value (-100 = full left, 0 = center, 100 = full right)",
1101
+ "tool.set_clip_panning": "Set the stereo panning for an individual audio clip. Range: -100 (full left) to +100 (full right). 0 = center.",
1102
+ "tool.set_clip_panning.param.clip_index": "Clip index on the track (0-based)",
1103
+ "tool.set_clip_panning.param.pan_value": "Pan value from -100 (full left) to +100 (full right)",
1104
+ "tool.set_clip_panning.param.track_index": "Audio track index (0-based)",
1105
+ "tool.set_clip_position": "Set the Position property on a video clip's Motion effect. Values are in pixels.",
1106
+ "tool.set_clip_position.param.node_id": "Node ID of the clip",
1107
+ "tool.set_clip_position.param.x": "X position in pixels",
1108
+ "tool.set_clip_position.param.y": "Y position in pixels",
1109
+ "tool.set_clip_properties": "Set properties on a clip (opacity, speed, etc.)",
1110
+ "tool.set_clip_properties.param.node_id": "Node ID of the clip",
1111
+ "tool.set_clip_properties.param.opacity": "Opacity value (0-100)",
1112
+ "tool.set_clip_properties.param.position_x": "Horizontal position",
1113
+ "tool.set_clip_properties.param.position_y": "Vertical position",
1114
+ "tool.set_clip_properties.param.rotation": "Rotation in degrees",
1115
+ "tool.set_clip_properties.param.scale": "Scale percentage (100 = original size)",
1116
+ "tool.set_clip_properties.param.speed": "Playback speed multiplier (1.0 = normal, 2.0 = double speed)",
1117
+ "tool.set_clip_rotation": "Set the Rotation property on a video clip's Motion effect.",
1118
+ "tool.set_clip_rotation.param.degrees": "Rotation in degrees (0-360, can exceed for multiple rotations)",
1119
+ "tool.set_clip_rotation.param.node_id": "Node ID of the clip",
1120
+ "tool.set_clip_scale": "Set the Scale property on a video clip's Motion effect.",
1121
+ "tool.set_clip_scale.param.node_id": "Node ID of the clip",
1122
+ "tool.set_clip_scale.param.scale": "Scale value (100 = original size, 200 = 2x, 50 = half)",
1123
+ "tool.set_clip_selection": "Select or deselect a clip in the active sequence",
1124
+ "tool.set_clip_selection.param.node_id": "Node ID of the clip",
1125
+ "tool.set_clip_selection.param.selected": "True to select, false to deselect",
1126
+ "tool.set_clip_speed_qe": "Set clip playback speed using QE DOM (more reliable than ExtendScript). Supports reverse.",
1127
+ "tool.set_clip_speed_qe.param.node_id": "Node ID of the clip",
1128
+ "tool.set_clip_speed_qe.param.reverse": "Reverse playback direction (default: false)",
1129
+ "tool.set_clip_speed_qe.param.speed_percent": "Speed as percentage (100 = normal, 200 = 2x, 50 = half speed)",
1130
+ "tool.set_clip_start_time": "Set the start time (timecode offset) of a project item. This shifts where timecode begins for the source media.",
1131
+ "tool.set_clip_start_time.param.item_id": "Node ID or name of the project item",
1132
+ "tool.set_clip_start_time.param.start_seconds": "New start time in seconds",
1133
+ "tool.set_clip_volume": "Set the volume level on an audio clip (in dB).",
1134
+ "tool.set_clip_volume.param.node_id": "Node ID of the audio clip",
1135
+ "tool.set_clip_volume.param.volume_db": "Volume in dB (0 = unity, negative = quieter, positive = louder)",
1136
+ "tool.set_color_label": "Set the color label on a project item or clip",
1137
+ "tool.set_color_label.param.color_index": "Label color index (0=Violet, 1=Iris, 2=Caribbean, 3=Lavender, 4=Cerulean, 5=Forest, 6=Rose, 7=Mango, 8=Purple, 9=Blue, 10=Teal, 11=Magenta, 12=Tan, 13=Green, 14=Brown, 15=Yellow)",
1138
+ "tool.set_color_label.param.item_id": "Node ID or name of the project item",
1139
+ "tool.set_color_value": "Set a color value on an effect property (e.g., tint color, fill color)",
1140
+ "tool.set_color_value.param.alpha": "Alpha (0-255)",
1141
+ "tool.set_color_value.param.blue": "Blue (0-255)",
1142
+ "tool.set_color_value.param.component_name": "Name of the component/effect",
1143
+ "tool.set_color_value.param.green": "Green (0-255)",
1144
+ "tool.set_color_value.param.node_id": "Node ID of the clip",
1145
+ "tool.set_color_value.param.property_name": "Name of the color property",
1146
+ "tool.set_color_value.param.red": "Red (0-255)",
1147
+ "tool.set_crop": "Crop a video clip by specified percentages from each edge using the Crop effect.",
1148
+ "tool.set_crop.param.bottom": "Crop from bottom edge as percentage (0-100). Default: 0.",
1149
+ "tool.set_crop.param.clip_index": "Clip index on the track (0-based)",
1150
+ "tool.set_crop.param.left": "Crop from left edge as percentage (0-100). Default: 0.",
1151
+ "tool.set_crop.param.right": "Crop from right edge as percentage (0-100). Default: 0.",
1152
+ "tool.set_crop.param.top": "Crop from top edge as percentage (0-100). Default: 0.",
1153
+ "tool.set_crop.param.track_index": "Video track index (0-based)",
1154
+ "tool.set_default_audio_transition_duration": "Set the default audio transition (crossfade) duration in seconds.",
1155
+ "tool.set_default_audio_transition_duration.param.seconds": "Default audio transition duration in seconds (e.g. 1.0)",
1156
+ "tool.set_default_sequence_preset": "Set the default sequence preset path used when creating new sequences.",
1157
+ "tool.set_default_sequence_preset.param.preset_path": "Full path to the sequence preset file (.sqpreset)",
1158
+ "tool.set_default_still_duration": "Set the default duration for still images when added to the timeline.",
1159
+ "tool.set_default_still_duration.param.frames": "Default still duration in frames (e.g. 150 frames = 5 seconds at 30fps)",
1160
+ "tool.set_default_transition_duration": "Set the default video transition duration in seconds.",
1161
+ "tool.set_default_transition_duration.param.seconds": "Default transition duration in seconds (e.g. 1.0)",
1162
+ "tool.set_effect_property": "Set the value of a specific effect property on a clip",
1163
+ "tool.set_effect_property.param.effect_name": "Display name of the effect (e.g., 'Motion', 'Opacity')",
1164
+ "tool.set_effect_property.param.node_id": "Node ID of the clip",
1165
+ "tool.set_effect_property.param.property_name": "Display name of the property (e.g., 'Scale', 'Position', 'Opacity')",
1166
+ "tool.set_effect_property.param.value": "Value to set",
1167
+ "tool.set_footage_interpretation": "Set footage interpretation settings for a project item",
1168
+ "tool.set_footage_interpretation.param.frame_rate": "Override frame rate",
1169
+ "tool.set_footage_interpretation.param.item_id": "Node ID or name of the project item",
1170
+ "tool.set_footage_interpretation.param.pixel_aspect_ratio": "Pixel aspect ratio (1.0 = square pixels)",
1171
+ "tool.set_frame_blend": "Enable or disable frame blending on a clip. Uses QE DOM.",
1172
+ "tool.set_frame_blend.param.enabled": "True to enable frame blending, false to disable",
1173
+ "tool.set_frame_blend.param.node_id": "Node ID of the clip",
1174
+ "tool.set_graphics_white_luminance": "Set the graphics white luminance value (HDR setting) for the project",
1175
+ "tool.set_graphics_white_luminance.param.luminance": "White luminance value in nits",
1176
+ "tool.set_item_in_out": "Set in and/or out points on a project item in the project panel (marks source range for editing).",
1177
+ "tool.set_item_in_out.param.in_seconds": "In point in seconds",
1178
+ "tool.set_item_in_out.param.item_id": "Node ID or name of the project item",
1179
+ "tool.set_item_in_out.param.media_type": "Media type: 1=video, 2=audio, 4=all (default: 4)",
1180
+ "tool.set_item_in_out.param.out_seconds": "Out point in seconds",
1181
+ "tool.set_keyframe_interpolation": "Set the interpolation type of a keyframe (Linear, Hold, or Bezier)",
1182
+ "tool.set_keyframe_interpolation.param.effect_name": "Display name of the effect",
1183
+ "tool.set_keyframe_interpolation.param.interpolation": "Interpolation type",
1184
+ "tool.set_keyframe_interpolation.param.node_id": "Node ID of the clip",
1185
+ "tool.set_keyframe_interpolation.param.property_name": "Display name of the property",
1186
+ "tool.set_keyframe_interpolation.param.time_seconds": "Time in seconds of the keyframe",
1187
+ "tool.set_metadata": "Set project metadata on a project item",
1188
+ "tool.set_metadata.param.field_name": "Metadata field name (e.g., 'Column.Intrinsic.Description')",
1189
+ "tool.set_metadata.param.item_id": "Node ID or name of the project item",
1190
+ "tool.set_metadata.param.value": "Value to set",
1191
+ "tool.set_offline": "Set a project item to offline status (unlinks its media)",
1192
+ "tool.set_offline.param.item_id": "Node ID or name of the project item",
1193
+ "tool.set_opacity_keyframes": "Set multiple opacity keyframes on a video clip for custom fade effects. Keyframes are relative to clip start.",
1194
+ "tool.set_opacity_keyframes.param.clip_index": "Clip index on the track (0-based)",
1195
+ "tool.set_opacity_keyframes.param.keyframes": "Array of keyframe objects: [{time: seconds_from_clip_start, value: opacity_0_to_100}]",
1196
+ "tool.set_opacity_keyframes.param.track_index": "Video track index (0-based)",
1197
+ "tool.set_override_frame_rate": "Override the frame rate of a project item (useful for image sequences or misinterpreted media)",
1198
+ "tool.set_override_frame_rate.param.frame_rate": "Frame rate to set (e.g., 23.976, 24, 29.97, 30, 60)",
1199
+ "tool.set_override_frame_rate.param.item_id": "Node ID or name of the project item",
1200
+ "tool.set_override_pixel_aspect_ratio": "Override the pixel aspect ratio of a project item",
1201
+ "tool.set_override_pixel_aspect_ratio.param.denominator": "PAR denominator (e.g., 1 for square pixels)",
1202
+ "tool.set_override_pixel_aspect_ratio.param.item_id": "Node ID or name of the project item",
1203
+ "tool.set_override_pixel_aspect_ratio.param.numerator": "PAR numerator (e.g., 1 for square pixels)",
1204
+ "tool.set_playback_resolution": "Set the playback resolution for the Program Monitor to improve performance.",
1205
+ "tool.set_playback_resolution.param.quality": "Resolution: 'full', 'half', 'quarter', or 'eighth'",
1206
+ "tool.set_playhead_position": "Set the playhead (CTI) position in the active sequence",
1207
+ "tool.set_playhead_position.param.time_seconds": "Time position in seconds to move the playhead to",
1208
+ "tool.set_poster_frame": "Set the poster frame (thumbnail) for a project item at a specific time.",
1209
+ "tool.set_poster_frame.param.item_id": "Node ID or name of the project item",
1210
+ "tool.set_poster_frame.param.time_seconds": "Time in seconds for the poster frame",
1211
+ "tool.set_project_panel_metadata": "Set the project panel metadata/column configuration from XML",
1212
+ "tool.set_project_panel_metadata.param.metadata_xml": "XML string containing the project panel metadata configuration",
1213
+ "tool.set_project_scratch_disk": "Set the project's scratch disk paths for captured video, audio, and previews.",
1214
+ "tool.set_project_scratch_disk.param.audio_previews": "Path for audio previews",
1215
+ "tool.set_project_scratch_disk.param.captured_audio": "Path for captured audio",
1216
+ "tool.set_project_scratch_disk.param.captured_video": "Path for captured video",
1217
+ "tool.set_project_scratch_disk.param.video_previews": "Path for video previews",
1218
+ "tool.set_renderer": "Set the video renderer for Premiere Pro (Software, Mercury CUDA, Mercury Metal, etc.).",
1219
+ "tool.set_renderer.param.renderer_name": "Renderer name (e.g. 'Mercury Playback Engine Software Only', 'Mercury Playback Engine GPU Acceleration (CUDA)')",
1220
+ "tool.set_scale_to_frame_size": "Enable 'Scale to Frame Size' on a project item so it fills the sequence frame",
1221
+ "tool.set_scale_to_frame_size.param.item_id": "Node ID or name of the project item",
1222
+ "tool.set_scale_width_height": "Set independent Scale Width and Scale Height on a clip (requires Uniform Scale to be OFF).",
1223
+ "tool.set_scale_width_height.param.node_id": "Node ID of the clip",
1224
+ "tool.set_scale_width_height.param.scale_height": "Scale height percentage",
1225
+ "tool.set_scale_width_height.param.scale_width": "Scale width percentage",
1226
+ "tool.set_scratch_disk_path": "Set the scratch disk path for a specific media type",
1227
+ "tool.set_scratch_disk_path.param.path": "Full directory path for the scratch disk",
1228
+ "tool.set_scratch_disk_path.param.scratch_disk_type": "Type: 'capturedVideo', 'capturedAudio', 'videoPreview', 'audioPreview', 'autoSave', 'ccLibraries'",
1229
+ "tool.set_sequence_audio_settings": "Change audio settings of the active sequence (sample rate, channel type).",
1230
+ "tool.set_sequence_audio_settings.param.channel_type": "Channel type: 0=Mono, 1=Stereo, 2=5.1, 3=Multichannel",
1231
+ "tool.set_sequence_audio_settings.param.sample_rate": "Audio sample rate (e.g., 44100, 48000, 96000)",
1232
+ "tool.set_sequence_color_space": "Set the color space for the active sequence.",
1233
+ "tool.set_sequence_color_space.param.color_space": "Color space name (e.g. 'Rec. 709', 'Rec. 2020', 'P3 D65', 'sRGB')",
1234
+ "tool.set_sequence_display_format": "Set the timecode display format for the active sequence.",
1235
+ "tool.set_sequence_display_format.param.audio_display_format": "Audio: 0=Audio Samples, 1=Milliseconds",
1236
+ "tool.set_sequence_display_format.param.video_display_format": "Video: 0=24 Timecode, 1=25 Timecode, 2=29.97 Drop-frame, 3=29.97 Non-drop-frame, 4=30 Timecode, 5=50 Timecode, 6=59.94 Drop-frame, 7=59.94 Non-drop-frame, 8=60 Timecode, 9=Frames, 10=Feet+Frames 16mm, 11=Feet+Frames 35mm",
1237
+ "tool.set_sequence_field_type": "Set the field order of the active sequence.",
1238
+ "tool.set_sequence_field_type.param.field_type": "0=No Fields (Progressive), 1=Upper Field First, 2=Lower Field First",
1239
+ "tool.set_sequence_frame_rate": "Change the frame rate of the active sequence.",
1240
+ "tool.set_sequence_frame_rate.param.frame_rate": "New frame rate (e.g., 23.976, 24, 25, 29.97, 30, 50, 59.94, 60)",
1241
+ "tool.set_sequence_in_out_points": "Set the sequence in and out points (for export range, etc.)",
1242
+ "tool.set_sequence_in_out_points.param.in_seconds": "In-point in seconds",
1243
+ "tool.set_sequence_in_out_points.param.out_seconds": "Out-point in seconds",
1244
+ "tool.set_sequence_pixel_aspect_ratio": "Change the pixel aspect ratio of the active sequence.",
1245
+ "tool.set_sequence_pixel_aspect_ratio.param.ratio": "Pixel aspect ratio (1.0 for square pixels, 1.4222 for 16:9 DV, etc.)",
1246
+ "tool.set_sequence_resolution": "Change the resolution (frame size) of the active sequence.",
1247
+ "tool.set_sequence_resolution.param.height": "Height in pixels",
1248
+ "tool.set_sequence_resolution.param.width": "Width in pixels",
1249
+ "tool.set_sequence_settings": "Update sequence settings such as frame size, frame rate, sample rate, and codec. Use get_sequence_settings first to see current values.",
1250
+ "tool.set_sequence_settings.param.display_format": "Timecode display format (102=SMPTE 29.97 drop, 103=SMPTE 29.97 non-drop)",
1251
+ "tool.set_sequence_settings.param.frame_rate": "Frame rate (e.g. 23.976, 24, 25, 29.97, 30, 59.94, 60)",
1252
+ "tool.set_sequence_settings.param.height": "Frame height in pixels (e.g. 1080, 720, 2160)",
1253
+ "tool.set_sequence_settings.param.sample_rate": "Audio sample rate in Hz (e.g. 44100, 48000)",
1254
+ "tool.set_sequence_settings.param.sequence_index": "Sequence index (0-based). Default: 0.",
1255
+ "tool.set_sequence_settings.param.width": "Frame width in pixels (e.g. 1920, 1280, 3840)",
1256
+ "tool.set_source_in_out": "Set in and/or out points on the clip currently open in the Source Monitor.",
1257
+ "tool.set_source_in_out.param.in_seconds": "In point in seconds (optional)",
1258
+ "tool.set_source_in_out.param.out_seconds": "Out point in seconds (optional)",
1259
+ "tool.set_start_time": "Set the start time (timecode offset) for a project item",
1260
+ "tool.set_start_time.param.item_id": "Node ID or name of the project item",
1261
+ "tool.set_start_time.param.start_seconds": "Start time in seconds",
1262
+ "tool.set_target_track": "Set a track as targeted (active for insert/overwrite edits). Only one video and one audio track can be targeted at a time.",
1263
+ "tool.set_target_track.param.targeted": "Whether to target (true) or untarget (false) the track",
1264
+ "tool.set_target_track.param.track_index": "Track index (0-based)",
1265
+ "tool.set_target_track.param.track_type": "Track type",
1266
+ "tool.set_time_display_format": "Set the time display format for the active sequence (timecode, frames, samples, etc.).",
1267
+ "tool.set_time_display_format.param.format": "Time format code (102=29.97 drop-frame, 103=29.97 NDF, 105=23.976, 201=frames, 202=feet+frames)",
1268
+ "tool.set_time_interpolation": "Set time interpolation type for a clip (Frame Sampling, Frame Blending, Optical Flow). Uses QE DOM.",
1269
+ "tool.set_time_interpolation.param.interpolation_type": "0 = Frame Sampling, 1 = Frame Blending, 2 = Optical Flow",
1270
+ "tool.set_time_interpolation.param.node_id": "Node ID of the clip",
1271
+ "tool.set_time_remapping": "Enable or disable time remapping on a video clip for variable speed effects.",
1272
+ "tool.set_time_remapping.param.clip_index": "Clip index on the track (0-based)",
1273
+ "tool.set_time_remapping.param.enabled": "True to enable time remapping, false to disable",
1274
+ "tool.set_time_remapping.param.track_index": "Video track index (0-based)",
1275
+ "tool.set_track_output": "Set the output channel assignment for an audio track.",
1276
+ "tool.set_track_output.param.output_channels": "Output channel assignment index",
1277
+ "tool.set_track_output.param.track_index": "Audio track index (0-based)",
1278
+ "tool.set_track_panning": "Set the stereo panning for an audio track. Range: -100 (full left) to +100 (full right). 0 = center.",
1279
+ "tool.set_track_panning.param.pan_value": "Pan value from -100 (full left) to +100 (full right)",
1280
+ "tool.set_track_panning.param.track_index": "Audio track index (0-based)",
1281
+ "tool.set_track_volume": "Set the volume level for an entire audio track in the active sequence.\n\nThis sets the track-level volume (the fader in the Audio Track Mixer), which affects all clips on the track. To set individual clip volume, use set_clip_properties or add_keyframe on the clip's Volume property instead.\n\nPreconditions: An active sequence must exist with audio tracks.\n\nVolume is specified in decibels (dB):\n- 0 dB = unity gain (no change from original level)\n- Positive values (e.g., +6 dB) boost the level\n- Negative values (e.g., -12 dB) reduce the level\n- -∞ (use -96 or lower) effectively mutes the track\n\nExample: set_track_volume({ track_index: 0, volume_db: -6 }) — reduce A1 by 6 dB\nExample: set_track_volume({ track_index: 1, volume_db: 0 }) — set A2 to unity gain\nExample: set_track_volume({ track_index: 2, volume_db: -96 }) — effectively mute A3",
1282
+ "tool.set_track_volume.param.track_index": "Audio track index (0-based: 0 = A1, 1 = A2, etc.)",
1283
+ "tool.set_track_volume.param.volume_db": "Volume in decibels (0 = unity, negative = quieter, positive = louder)",
1284
+ "tool.set_transcode_on_ingest": "Enable or disable transcoding on ingest for the project",
1285
+ "tool.set_transcode_on_ingest.param.enabled": "True to enable transcode on ingest, false to disable",
1286
+ "tool.set_uniform_scale": "Enable or disable uniform scaling (lock/unlock width-height scale ratio) for a video clip.",
1287
+ "tool.set_uniform_scale.param.clip_index": "Clip index on the track (0-based)",
1288
+ "tool.set_uniform_scale.param.enabled": "True to lock uniform scale, false to allow independent width/height scaling",
1289
+ "tool.set_uniform_scale.param.track_index": "Video track index (0-based)",
1290
+ "tool.set_video_track_target": "Set whether a video track is targeted for editing operations.",
1291
+ "tool.set_video_track_target.param.targeted": "True to target this track, false to untarget",
1292
+ "tool.set_video_track_target.param.track_index": "Video track index (0-based)",
1293
+ "tool.set_video_transition_default_duration": "Set the default duration for video transitions in frames.",
1294
+ "tool.set_video_transition_default_duration.param.frames": "Default transition duration in frames (e.g. 25 for ~1 second at 25fps)",
1295
+ "tool.set_voiceover_ducking": "Set up automatic audio ducking so music lowers when voiceover is present. Adds volume keyframes on music track around VO clips.",
1296
+ "tool.set_voiceover_ducking.param.duck_amount": "How much to lower the music in dB (e.g. -15). Default: -15.",
1297
+ "tool.set_voiceover_ducking.param.music_track_index": "Music track index to duck (0-based)",
1298
+ "tool.set_voiceover_ducking.param.sensitivity": "Fade duration in seconds before/after VO clip. Default: 0.5.",
1299
+ "tool.set_voiceover_ducking.param.vo_track_index": "Voiceover track index (0-based)",
1300
+ "tool.set_work_area": "Set the work area (bar) in and out points",
1301
+ "tool.set_work_area.param.in_seconds": "Work area in-point in seconds",
1302
+ "tool.set_work_area.param.out_seconds": "Work area out-point in seconds",
1303
+ "tool.set_workspace": "Switch to a specific workspace layout (e.g., 'Editing', 'Color', 'Audio', 'Effects', 'Graphics')",
1304
+ "tool.set_workspace.param.name": "Name of the workspace to activate (use get_workspaces to see available options)",
1305
+ "tool.set_xmp_metadata": "Set raw XMP metadata on a project item (provide complete XMP XML string)",
1306
+ "tool.set_xmp_metadata.param.item_id": "Node ID or name of the project item",
1307
+ "tool.set_xmp_metadata.param.xmp_xml": "Complete XMP metadata XML string to set",
1308
+ "tool.set_zero_point": "Set the starting timecode (zero point) of a sequence",
1309
+ "tool.set_zero_point.param.sequence_id": "Sequence name or ID. Uses active sequence if omitted.",
1310
+ "tool.set_zero_point.param.start_seconds": "Start time in seconds for the timecode origin",
1311
+ "tool.slide_edit": "Perform a slide edit on a clip (moves clip without changing its duration, adjusting adjacent clips). Uses QE DOM.",
1312
+ "tool.slide_edit.param.node_id": "Node ID of the clip",
1313
+ "tool.slide_edit.param.offset_seconds": "Offset in seconds (positive = slide right, negative = slide left)",
1314
+ "tool.slip_edit": "Perform a slip edit on a clip (changes source in/out points without moving clip on timeline). Uses QE DOM.",
1315
+ "tool.slip_edit.param.node_id": "Node ID of the clip",
1316
+ "tool.slip_edit.param.offset_seconds": "Offset in seconds (positive = slip forward in source, negative = slip backward)",
1317
+ "tool.solo_audio_track": "Solo or unsolo an audio track (only this track plays when soloed).",
1318
+ "tool.solo_audio_track.param.soloed": "True to solo, false to unsolo",
1319
+ "tool.solo_audio_track.param.track_index": "Audio track index (0-based)",
1320
+ "tool.speed_change": "Change the playback speed of a clip on the timeline.\n\nPreconditions: Active sequence required. Clip node_id must be valid.\n\nSpeed is specified as a percentage number (NOT a multiplier):\n - 100 = normal speed\n - 200 = double speed (2x faster)\n - 50 = half speed (slow motion)\n - 25 = quarter speed\n\nUse reverse=true to play the clip backwards (negative speed). This internally uses a negative percentage.\n\nNote: setSpeed() expects a numeric percentage, not a string and not a decimal multiplier. Passing \"50\" as a string or 0.5 as a multiplier would fail.\n\nExample: speed_change({ node_id: \"abc123\", speed_percent: 200 }) — 2x speed\nExample: speed_change({ node_id: \"abc123\", speed_percent: 50, reverse: true }) — half speed, reversed",
1321
+ "tool.speed_change.param.node_id": "Node ID of the clip",
1322
+ "tool.speed_change.param.reverse": "Reverse playback direction (default: false)",
1323
+ "tool.speed_change.param.speed_percent": "Speed as percentage (100 = normal, 200 = double, 50 = half)",
1324
+ "tool.split_clip": "Split (razor cut) a clip at a specific timeline position. Uses QE DOM.\n\nPreconditions: An active sequence must exist with at least one clip on the specified track. The time_seconds must fall within a clip on the specified track — splitting empty space has no effect.\n\nAfter the split, the original clip becomes two separate clips that can be independently moved, trimmed, or deleted.\n\nExample: split_clip({ time_seconds: 30.0 }) — split V1 at 30 seconds\nExample: split_clip({ time_seconds: 15.5, track_index: 1, track_type: \"video\" })",
1325
+ "tool.split_clip.param.time_seconds": "Time position in seconds where to split",
1326
+ "tool.split_clip.param.track_index": "Track index (0-based)",
1327
+ "tool.split_clip.param.track_type": "Track type (default: video)",
1328
+ "tool.stabilize_clip": "Apply the Warp Stabilizer effect to a clip for video stabilization. Uses QE DOM.",
1329
+ "tool.stabilize_clip.param.method": "Stabilization method (default: 'Subspace Warp')",
1330
+ "tool.stabilize_clip.param.node_id": "Node ID of the clip to stabilize",
1331
+ "tool.stabilize_clip.param.smoothness": "Stabilization smoothness percentage (default: 50). Higher = smoother but more cropping.",
1332
+ "tool.start_ame_batch": "Start encoding the batch queue in Adobe Media Encoder.",
1333
+ "tool.start_batch_encode": "Start encoding all items in the Adobe Media Encoder render queue",
1334
+ "tool.stop_playback": "Stop playback of the active sequence timeline. Uses QE DOM.",
1335
+ "tool.switch_multicam_angle": "Switch the camera angle of a multicam clip at a specific time point. Used during multicam editing to cut between cameras.",
1336
+ "tool.switch_multicam_angle.param.angle_index": "Camera angle index to switch to (0-based)",
1337
+ "tool.switch_multicam_angle.param.time": "Time in seconds where the angle switch should occur",
1338
+ "tool.switch_multicam_angle.param.track_index": "Video track index containing the multicam clip (0-based)",
1339
+ "tool.toggle_proxies": "Enable or disable proxy playback for the entire project.",
1340
+ "tool.toggle_proxies.param.enabled": "True to enable proxy playback, false to use original media",
1341
+ "tool.toggle_track_visibility": "Toggle a video track's visibility (eye icon)",
1342
+ "tool.toggle_track_visibility.param.track_index": "Video track index (0-based)",
1343
+ "tool.toggle_track_visibility.param.visible": "True to show, false to hide",
1344
+ "tool.trim_clip": "Trim a clip's in-point and/or out-point on the timeline.\n\nPreconditions: Clip must exist on the active sequence (use node_id from get_active_sequence).\n\nTime values are in seconds relative to the clip's source media (not the timeline position). For example, if a 60-second clip starts at timeline position 10s, setting new_in_seconds=5 trims the first 5 seconds of the source, making the clip start 5s into the original footage.\n\nNote: Uses clip.setInPoint(time, 2) and clip.setOutPoint(time, 2) — the alignment constant 2 (kTime) is required. Direct assignment to clip.inPoint / clip.outPoint does not work in ExtendScript.\n\nExample: trim_clip({ node_id: \"abc123\", new_in_seconds: 2.0 }) — trim 2s off the start\nExample: trim_clip({ node_id: \"abc123\", new_out_seconds: 58.5 }) — trim the end to 58.5s\nExample: trim_clip({ node_id: \"abc123\", new_in_seconds: 1.0, new_out_seconds: 59.0 }) — trim both ends",
1345
+ "tool.trim_clip.param.new_in_seconds": "New in-point in seconds (relative to clip's source media)",
1346
+ "tool.trim_clip.param.new_out_seconds": "New out-point in seconds (relative to clip's source media)",
1347
+ "tool.trim_clip.param.node_id": "Node ID of the clip to trim",
1348
+ "tool.undo": "Undo the last action in Premiere Pro",
1349
+ "tool.undo.param.count": "Number of times to undo (default: 1)",
1350
+ "tool.unlink_selection": "Unlink the currently selected video and audio clips in the active sequence",
1351
+ "tool.unmute_all_audio_tracks": "Unmute all audio tracks in the active sequence.",
1352
+ "tool.unnest_sequence": "Unnest a nested sequence on the timeline, replacing it with the contents of the nested sequence",
1353
+ "tool.unnest_sequence.param.node_id": "Node ID of the nested sequence clip on the timeline to unnest",
1354
+ "tool.update_marker": "Update an existing marker's properties",
1355
+ "tool.update_marker.param.color": "New color index",
1356
+ "tool.update_marker.param.comments": "New comments",
1357
+ "tool.update_marker.param.name": "New name",
1358
+ "tool.update_marker.param.node_id": "Optional clip node ID (updates sequence marker if omitted)",
1359
+ "tool.update_marker.param.time_seconds": "Time position of the marker to update",
1360
+ "ui.bridge.activity.title": "Activity log",
1361
+ "ui.bridge.controls.save": "Save",
1362
+ "ui.bridge.controls.start": "Start bridge",
1363
+ "ui.bridge.controls.stop": "Stop",
1364
+ "ui.bridge.error.execTimeout": "ExtendScript execution timed out after {seconds} seconds. Premiere Pro may be busy or unresponsive.",
1365
+ "ui.bridge.footer.builtBy": "Built by",
1366
+ "ui.bridge.header.openSite": "Open synthetic.com.ar",
1367
+ "ui.bridge.license.empty": "Enter a license key before saving.",
1368
+ "ui.bridge.license.none": "No license key saved yet — required for updates.",
1369
+ "ui.bridge.license.requiredForUpdate": "License key required before updating.",
1370
+ "ui.bridge.license.saveFailed": "Failed to save license key (see log).",
1371
+ "ui.bridge.license.saved": "License key saved.",
1372
+ "ui.bridge.log.autoStart": "Temp directory exists, auto-starting...",
1373
+ "ui.bridge.log.createDirFailed": "Error creating dir: {error}",
1374
+ "ui.bridge.log.downloading": "Downloading {file}...",
1375
+ "ui.bridge.log.execTimeout": "Execution timed out after {seconds}s",
1376
+ "ui.bridge.log.executing": "Executing: {file} ({chars} chars)",
1377
+ "ui.bridge.log.libraryLoaded": "premiere.jsx loaded: {result}",
1378
+ "ui.bridge.log.licenseSaveError": "Error saving license key: {error}",
1379
+ "ui.bridge.log.loaded": "{name} loaded",
1380
+ "ui.bridge.log.noUpdate": "No update to apply",
1381
+ "ui.bridge.log.readFailed": "Failed to read: {file}",
1382
+ "ui.bridge.log.resultError": "Result: Error — {error}",
1383
+ "ui.bridge.log.resultOk": "Result: OK",
1384
+ "ui.bridge.log.resultOkEmpty": "Result: OK (null/undefined)",
1385
+ "ui.bridge.log.resultOkRaw": "Result: OK (raw)",
1386
+ "ui.bridge.log.resultRaw": "Result: {result}",
1387
+ "ui.bridge.log.sizeDiffers": "Size differs from manifest for {file} ({actual} vs {expected}) — continuing",
1388
+ "ui.bridge.log.started": "Bridge started. Temp dir: {dir}",
1389
+ "ui.bridge.log.stopped": "Bridge stopped",
1390
+ "ui.bridge.log.tempDirMissing": "Please set a temp directory",
1391
+ "ui.bridge.log.tempDirSaved": "Temp directory saved: {dir}",
1392
+ "ui.bridge.log.unknownError": "unknown",
1393
+ "ui.bridge.log.updateAborted": "Update aborted: {reason}",
1394
+ "ui.bridge.log.updateApplied": "Update v{version} applied. RESTART PREMIERE PRO to load the new panel.",
1395
+ "ui.bridge.log.updateNoLicense": "Update failed: no license key saved. Open Settings and paste your Premiere MCP license key.",
1396
+ "ui.bridge.log.versionUnknown": "Warning: Could not detect Premiere Pro version",
1397
+ "ui.bridge.log.writeFailed": "Error writing {file}: {error}",
1398
+ "ui.bridge.product.statusReady": "Panel ready",
1399
+ "ui.bridge.product.subtitle": "Bridge · {count} tools",
1400
+ "ui.bridge.settings.licenseKey": "License key",
1401
+ "ui.bridge.settings.licensePlaceholder": "Paste your Premiere MCP license key",
1402
+ "ui.bridge.settings.saveLicense": "Save license",
1403
+ "ui.bridge.stats.commandsProcessed": "Commands processed:",
1404
+ "ui.bridge.status.errors": "Running — {count} consecutive error(s)",
1405
+ "ui.bridge.status.polling": "Running — polling {dir}",
1406
+ "ui.bridge.status.ready": "Ready — click Start Bridge",
1407
+ "ui.bridge.status.running": "Running — {count} commands processed",
1408
+ "ui.bridge.status.stopped": "Stopped",
1409
+ "ui.bridge.status.unresponsive": "Running — Premiere Pro unresponsive ({count} errors)",
1410
+ "ui.bridge.status.updateApplied": "Update applied — restart Premiere Pro",
1411
+ "ui.bridge.status.updateFailed": "Update failed",
1412
+ "ui.bridge.tempDir.label": "Temp directory",
1413
+ "ui.bridge.toolbar.reload": "Reload panel",
1414
+ "ui.bridge.toolbar.settings": "Settings",
1415
+ "ui.bridge.update.appliedBody": "Close and reopen Premiere Pro to activate v{version}.",
1416
+ "ui.bridge.update.appliedTitle": "Update applied.",
1417
+ "ui.bridge.update.available": "Update available",
1418
+ "ui.bridge.update.backupFailed": "Backup failed for {file}: {error}",
1419
+ "ui.bridge.update.commitFailed": "Commit failed (rolled back): {error}",
1420
+ "ui.bridge.update.downloadFailed": "Download failed for {file}: {error}",
1421
+ "ui.bridge.update.installerHint": "If hot-swap fails or the release needs a fresh manifest",
1422
+ "ui.bridge.update.later": "Later",
1423
+ "ui.bridge.update.now": "Update now",
1424
+ "ui.bridge.update.ok": "OK",
1425
+ "ui.bridge.update.shaMismatch": "SHA256 mismatch for {file} (got {got}..., expected {expected}...)",
1426
+ "ui.bridge.update.updating": "Updating...",
1427
+ "ui.chat.context.noProject": "No project open",
1428
+ "ui.chat.context.notConnected": "Not connected to Premiere Pro",
1429
+ "ui.chat.context.refresh": "Refresh",
1430
+ "ui.chat.error.api": "API error",
1431
+ "ui.chat.error.connectionFailed": "connection failed",
1432
+ "ui.chat.error.network": "Network error: {error}",
1433
+ "ui.chat.error.noResponse": "No response received",
1434
+ "ui.chat.error.parse": "Failed to parse response: {error}",
1435
+ "ui.chat.error.timeout": "Request timed out ({seconds}s)",
1436
+ "ui.chat.error.unknown": "Unknown error",
1437
+ "ui.chat.error.unknownProvider": "Unknown provider: {provider}",
1438
+ "ui.chat.field.apiKey": "API Key",
1439
+ "ui.chat.field.model": "Model",
1440
+ "ui.chat.header.clear": "Clear chat",
1441
+ "ui.chat.header.disconnect": "Disconnect",
1442
+ "ui.chat.header.settings": "Settings",
1443
+ "ui.chat.input.placeholder": "Ask me to edit your project...",
1444
+ "ui.chat.input.send": "Send",
1445
+ "ui.chat.login.apiKeyPlaceholder": "Enter your API key...",
1446
+ "ui.chat.login.connect": "Connect & Start Chatting",
1447
+ "ui.chat.login.connecting": "Connecting...",
1448
+ "ui.chat.login.emptyKey": "Please enter an API key.",
1449
+ "ui.chat.login.failed": "Connection failed: {error}",
1450
+ "ui.chat.login.keyHint": "Get a key at {link}",
1451
+ "ui.chat.login.privacy": "Your API key is stored locally and never leaves this machine.",
1452
+ "ui.chat.login.subtitle": "Connect an AI provider to control Premiere Pro with natural language.",
1453
+ "ui.chat.login.title": "Premiere Pro AI Chat",
1454
+ "ui.chat.login.toggleKey": "Show/hide key",
1455
+ "ui.chat.message.empty": "(empty response)",
1456
+ "ui.chat.message.error": "**Error:** {error}",
1457
+ "ui.chat.message.keyInvalid": "**Warning:** Saved API key may be invalid — {error}. You can update it in Settings.",
1458
+ "ui.chat.script.error": "Error: {error}",
1459
+ "ui.chat.script.execute": "Execute",
1460
+ "ui.chat.script.noReturn": "(no return value)",
1461
+ "ui.chat.script.parseError": "Parse error: {result}",
1462
+ "ui.chat.script.preview": "ExtendScript (preview)",
1463
+ "ui.chat.script.result": "ExtendScript Result",
1464
+ "ui.chat.script.running": "Running...",
1465
+ "ui.chat.settings.autoExec": "Auto-execute ExtendScript (uncheck to preview first)",
1466
+ "ui.chat.settings.changeApiKey": "Change API Key",
1467
+ "ui.chat.settings.maxTokens": "Max Tokens",
1468
+ "ui.chat.settings.save": "Save",
1469
+ "ui.chat.settings.systemPrompt": "System Prompt (appended to default)",
1470
+ "ui.chat.settings.systemPromptPlaceholder": "Add custom instructions...",
1471
+ "ui.chat.settings.temperature": "Temperature",
1472
+ "ui.chat.settings.title": "Settings",
1473
+ "ui.chat.status.error": "Error",
1474
+ "ui.chat.status.executing": "Executing script...",
1475
+ "ui.chat.status.ready": "Ready",
1476
+ "ui.chat.status.thinking": "Thinking...",
1477
+ "ui.chat.suggestion.dissolve": "Add a cross dissolve to all cuts",
1478
+ "ui.chat.suggestion.export": "Export as H.264",
1479
+ "ui.chat.suggestion.exportPrompt": "Export the active sequence as H.264",
1480
+ "ui.chat.suggestion.timeline": "What clips are in my timeline?",
1481
+ "ui.chat.tokens": "{input} in / {output} out",
1482
+ "ui.chat.welcome.body": "I can help you edit in Premiere Pro. Try:",
1483
+ "ui.chat.welcome.title": "Welcome!",
1484
+ "ui.i18n.language": "Language",
1485
+ "ui.i18n.restartNote": "The AI tool descriptions switch language after you restart the MCP server (or the app that runs it).",
1486
+ "ui.i18n.saveFailed": "Couldn't save the language preference. It will only last for this session.",
1487
+ "ui.i18n.saved": "Language saved."
1488
+ }