add_clip
Places a project item on the timeline at a chosen position, overwriting by default or ripple-inserting when insert is enabled.
Instructions
Place a project item on the timeline. Overwrites by default; set insert=true to ripple-insert. The picture goes to track and linked sound to audioTrack.
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": {
"item": "<item>"
},
"name": "add_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| in | No | Source in point, in seconds | |
| out | No | Source out point in seconds; omit to use the rest of the media | |
| item | Yes | Project item id (from import_media / inspect_project) | |
| audio | No | ||
| track | No | Track name such as "V1", "V2", "A1" | V1 |
| video | No | ||
| insert | No | ||
| project | No | Path to the .fcproj project file; omit to edit the FilmCraft app connected with connect_app | |
| position | No | Timeline position, in seconds | |
| audioTrack | No | Audio destination, e.g. "A1" |