add_text_overlay
Add custom text to every frame of a video with configurable position, color, and font size. Provide the input file and text to generate an annotated output.
Instructions
Burn a text string onto every frame of a video using the ffmpeg drawtext filter.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_path": "<file_path>",
"text": "<text>"
},
"name": "add_text_overlay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | X position of the text (pixels from left, default 10) | |
| y | No | Y position of the text (pixels from top, default 10) | |
| text | Yes | Text to overlay on the video (max 500 characters) | |
| color | No | Font color as a name (e.g. 'white', 'red') or hex (e.g. '#FF0000'). Default 'white'. | |
| file_path | Yes | Absolute path to the input video file | |
| font_size | No | Font size in pixels (default 24) | |
| output_path | No | Absolute path for the output file. Defaults to same directory with '_text' suffix. |