Command · Apply Effect
clip.addEffect
Adds an effect to the stack of each clip (video effects on video clips, audio effects on audio clips).
- v1
- Capability EditSequence
- Tool
clip_addEffect
Request
{
"command": "clip.addEffect",
"params": {
"clips": [
42
],
"effect": "wabcut.blur.gaussian",
"params": {
"radius": 12
}
}
}Parameters
clips(integer | object (1..))[], min 1Required- Clips to add the effect to.
effect`wabcut.color.basic` | `wabcut.vignette` | `wabcut.color.grade` | `wabcut.blur.gaussian` | `wabcut.sharpen` | `wabcut.crop` | `wabcut.dropShadow` | `wabcut.title.style` | `wabcut.mask` | `wabcut.mosaic` | `wabcut.key.trackMatte` | `wabcut.border` | `wabcut.key.ultra` | `wabcut.audio.gain` | `wabcut.audio.eq3` | `wabcut.audio.compressor` | `wabcut.audio.limiter` | `wabcut.audio.denoise` | `wabcut.audio.enhanceSpeech` | `wabcut.audio.filter` | `wabcut.audio.dehum` | `wabcut.audio.deess` | `wabcut.audio.expander` | `wabcut.audio.reverb` | `wabcut.audio.width` | `wabcut.audio.essentialSound`- The effect id (effect.list).
indexinteger (0..)- Position in the stack (0 = first). Default: last.
paramsobject- Parameter values by key, e.g. {"radius": 12}.
pluginstring- Or an audio plugin's effect id (plugins.list), e.g. "plugin.vst3.".
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
Adds an effect to the stack of each clip (video effects on video clips, audio effects on audio clips). Parameters not given take their defaults. An audio plugin ("plugin": its effect id from plugins.list) goes on audio clips the same way. The new instance ids are returned in createdIds.
Run it with wabcut-cli cmd <project> --json, from an MCP client as clip_addEffect, or from an extension. See Edit commands for requests, references and results.
See also
clip.*
- clip.addKeyframe
Add Keyframe. Adds a keyframe at a timeline time inside the clip (or replaces the one there).
- clip.details
Clip Details. Everything about one clip: track, timeline and source range (ticks and timecode), media, stream, speed, enabled, label colour, linked clips and all parameter values.
- clip.enable
Enable. Enables or disables clips (Premiere Shift+E).
- clip.fade
Fade. Fades clips in and/or out with keyframes: opacity on video clips (to 0), level on audio clips (to -144 dB).
- clip.find
Find Clips. Finds clips by name (case-insensitive substring), by a time they cover, by track and by media.
- clip.frameHold
Frame Hold. Holds the frame at a time.
- clip.insert
Insert. Insert edit (Premiere ','): puts a media source range onto the patched tracks at a time and pushes later material on those tracks and every sync-locked track later, cutting through clips there.
- clip.instantReplay
Instant Replay. Replays a moment right after itself in slow motion, Premiere-style instant replay in one step: the moment's clips are copied and inserted right after it (everything later moves, sync-locked tracks stay in sync) with a speed ramp (100 % easing into "speed" and back), the REPLAY stinger template over the replay and a white flash at each cut.
- clip.link
Link. Links clips so they select and edit together.
- clip.move
Move. Moves clips in time and across tracks.
- clip.moveEffect
Reorder Effect. Moves an effect to another position in the clip's stack.
- clip.moveKeyframe
Move Keyframe. Moves a keyframe to another timeline time inside the clip.
- clip.openNested
Open Nested Sequence. The sequence a nested or multicam clip plays (open it to edit inside), the range of it the clip shows and, for a multicam clip, its active angles.
- clip.overwrite
Overwrite. Overwrite edit (Premiere '.'): puts a media source range onto the patched tracks at a time, replacing whatever is there.
- clip.pasteAttributes
Paste Attributes. Premiere's Paste Attributes (Ctrl+Alt+V): the chosen attributes of the clipboard's clip (the first one of each target's kind: video attributes from the copied video clip, audio ones from the audio clip) or of "source" onto "clips".
- clip.removeAttributes
Remove Attributes. Premiere's Remove Attributes: the chosen parameters go back to their defaults (keyframes too), time remapping is turned off (the clip plays at 100 % from the frame it started on), effects are removed by id (or all).
- clip.removeEffect
Remove Effect. Removes an effect instance from a clip's stack.
- clip.removeKeyframe
Remove Keyframe. Removes a keyframe; removing the last one leaves the parameter constant at its value.
- clip.rename
Rename Clip. Renames clips (the name shown on the timeline; the media keeps its name).
- clip.rippleTrim
Ripple Edit. Ripple edit (B): moves a clip's In or Out point and ripples later material (sync-locked tracks too).
- clip.roll
Rolling Edit. Rolling edit (N): moves the edit point at a clip's edge, trimming the neighbour the other way.
- clip.setAnimated
Toggle Animation. Premiere's stopwatch.
- clip.setBlendMode
Set Blend Mode. Sets the blend mode of video clips (the Opacity section's Blend Mode, Premiere's list): how each clip combines with what is below it.
- clip.setColor
Set Label Color. Sets the label colour of clips (0-15).
- clip.setEffect
Set Effect. Turns an effect on or off or sets its parameters (constants; animate them with clip.addKeyframe and "effect").
- clip.setKeyframe
Set Keyframe. Changes a keyframe's value, interpolation (hold, linear, bezier, easeIn, easeOut, easeInOut) or Bezier handles (slope in units per second, influence 0..1 of the segment).
- clip.setParam
Set Clip Parameter. Sets one effect parameter (motion, opacity, volume, pan) on clips.
- clip.shake
Camera Shake. A camera shake on a video clip from "at": Motion Position (and Rotation) keys of a seeded random pattern that decays over "seconds", plus a slight zoom so the clip's edges do not show ("cover").
- clip.slide
Slide. Slide (U): moves a clip between its neighbours, trimming them to compensate.
- clip.slip
Slip. Slip (Y): shifts which source frames clips show, keeping their place and length.
- clip.speedDuration
Speed/Duration. Ctrl+R: plays each clip's material at a new speed (percent; 200 = twice as fast) or fits it into a new duration; can reverse it and keep audio pitch.
- clip.splitAtShots
Split at Shots. Razors each clip at the cuts in its video (scene-edit detection), with its linked partners.
- clip.trim
Trim. Trim an edge (selection tool): moves a clip's In or Out point without moving anything else.
- clip.unlink
Unlink. Takes clips out of their link groups.
- clip.zoomPunch
Zoom Punch. A punch-in zoom on a moment of a video clip: Motion Scale keys ease in to "scale" times the clip's scale, hitting at "at", hold, and ease back out ("attack" and "release" are shares of "seconds").