Add Music Bed
music_bedAdds background music to a video, looping or trimming it to length, fading, leveling, and mixing with any existing audio while stream-copying the video.
Instructions
Lay music under a video: looped or trimmed to length, faded, leveled, and mixed with any existing audio. Video is stream-copied.
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": {
"video": "<video>",
"music": "<music>"
},
"name": "music_bed"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duck | No | Duck the music under the original audio (default false). | |
| music | Yes | Music audio file. | |
| video | Yes | Path to the video. | |
| fadeIn | No | Fade-in seconds (default 1). | |
| output | No | Optional output path. Defaults under SCREENCAST_HOME/edits. | |
| fadeOut | No | Fade-out seconds (default 2). | |
| overwrite | No | Allow replacing an existing file at the output path (default false). | |
| musicVolume | No | 0..1 (default 0.25 over existing audio, 0.8 alone). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outputPath | Yes | Path of the file written. |