add_image_overlay

Add an image overlay (watermark/logo) to videos with customizable position, size, opacity, and timing. Specify start/end times and exact placement for precise branding or design enhancements.

Instructions

Adds an image overlay (watermark/logo) to a video.

Args: video_path: Path to the input video file. output_video_path: Path to save the video with the image overlay. image_path: Path to the image file for the overlay. position: Position of the overlay. Options: 'top_left', 'top_right', 'bottom_left', 'bottom_right', 'center'. Or specify custom coordinates like 'x=10=10'. opacity: Opacity of the overlay (0.0 to 1.0). If None, image's own alpha is used. start_time: Start time for the overlay (HH:SS or seconds). If None, starts from beginning. end_time: End time for the overlay (HH:SS or seconds). If None, lasts till end. width: Width for the overlay image (e.g., '100', 'iw0.1'). Original if None. height: Height for the overlay image (e.g., '50', 'ih0.1'). Original if None.

Returns: A status message indicating success or failure.

Input Schema

Name	Required	Default
`end_time`	No
`height`	No
`image_path`	Yes
`opacity`	No
`output_video_path`	Yes
`position`	No	top_right
`start_time`	No
`video_path`	Yes
`width`	No

Input Schema (JSON Schema)

{
  "properties": {
    "end_time": {
      "default": null,
      "title": "End Time",
      "type": "string"
    },
    "height": {
      "default": null,
      "title": "Height",
      "type": "string"
    },
    "image_path": {
      "title": "Image Path",
      "type": "string"
    },
    "opacity": {
      "default": null,
      "title": "Opacity",
      "type": "number"
    },
    "output_video_path": {
      "title": "Output Video Path",
      "type": "string"
    },
    "position": {
      "default": "top_right",
      "title": "Position",
      "type": "string"
    },
    "start_time": {
      "default": null,
      "title": "Start Time",
      "type": "string"
    },
    "video_path": {
      "title": "Video Path",
      "type": "string"
    },
    "width": {
      "default": null,
      "title": "Width",
      "type": "string"
    }
  },
  "required": [
    "video_path",
    "output_video_path",
    "image_path"
  ],
  "title": "add_image_overlayArguments",
  "type": "object"
}

Video & Audio Editing MCP Server