remove_effect
Remove specific effects from video clips in Adobe Premiere Pro to clean up edits or revert changes.
Instructions
Removes an effect from a clip.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clipId | Yes | The ID of the clip | |
| effectName | Yes | The name of the effect to remove |
Implementation Reference
- src/tools/index.ts:1234-1280 (handler)The primary handler function for the 'remove_effect' tool. It constructs an ExtendScript that finds the clip by ID, iterates through its effects to find the matching effect name, removes it, and returns success/error status via the PremiereProBridge.private async removeEffect(clipId: string, effectName: string): Promise<any> { const script = ` try { var clip = app.project.getClipByID("${clipId}"); if (!clip) { JSON.stringify({ success: false, error: "Clip not found" }); return; } var effects = clip.getEffects(); var removed = false; for (var i = 0; i < effects.length; i++) { if (effects[i].displayName === "${effectName}") { clip.removeEffect(effects[i]); removed = true; break; } } if (!removed) { JSON.stringify({ success: false, error: "Effect not found on clip" }); return; } JSON.stringify({ success: true, message: "Effect removed successfully", clipId: "${clipId}", effectName: "${effectName}" }); } catch (e) { JSON.stringify({ success: false, error: e.toString() }); } `; return await this.bridge.executeScript(script); }
- src/tools/index.ts:200-207 (registration)The 'remove_effect' tool is registered in the getAvailableTools() method, defining its name, description, and Zod input schema for validation.{ name: 'remove_effect', description: 'Removes an effect from a clip.', inputSchema: z.object({ clipId: z.string().describe('The ID of the clip'), effectName: z.string().describe('The name of the effect to remove') }) },
- src/tools/index.ts:477-478 (registration)In the executeTool method's switch statement, the 'remove_effect' case dispatches to the removeEffect handler with parsed arguments.return await this.removeEffect(args.clipId, args.effectName); case 'add_transition':
- src/tools/index.ts:203-206 (schema)Zod schema definition for 'remove_effect' tool inputs: clipId (string) and effectName (string).inputSchema: z.object({ clipId: z.string().describe('The ID of the clip'), effectName: z.string().describe('The name of the effect to remove') })