Convert Format
convertConvert source media into mp4 (H.264), webm (VP9), or gif files, with optional fps, width, and output path settings. Use it when a recording or clip must be re-encoded to a different format.
Instructions
Convert media to mp4, webm, or gif. For a size-bounded GIF/WebP prefer export_gif; for a smaller mp4, compress or export_preset.
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": {
"input": "<input>",
"format": "<format>"
},
"name": "convert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | gif only: fps (default 12). | |
| input | Yes | Path to the source media. | |
| width | No | gif only: width in px (default 720). | |
| format | Yes | mp4 (H.264), webm (VP9), or gif (palette). | |
| output | No | Optional output path. Defaults under SCREENCAST_HOME/edits. | |
| overwrite | No | Allow replacing an existing file at the output path (default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outputPath | Yes | Path of the file written. |