music_bed
Adds background music to a video by looping or trimming it to the video length, applying fades and volume, and mixing or ducking it under existing audio.
Instructions
Lay a music track under a video: the music is looped/trimmed to the video length, faded in and out, and leveled. When the video already has audio the two are mixed, optionally ducking the music under the original. The video stream is copied; only audio is re-encoded.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duck | No | Duck the music under the original audio via a sidechain (default false). | |
| music | Yes | Path to the music audio file (looped/trimmed to the video length). | |
| video | Yes | Path to the video. | |
| fadeIn | No | Music fade-in seconds (default 1). | |
| output | No | Optional output path. Defaults under SCREENCAST_HOME/edits. | |
| fadeOut | No | Music fade-out seconds (default 2). | |
| overwrite | No | Allow replacing an existing file at the output path (default false). | |
| musicVolume | No | Music level 0..1 (default 0.25 over existing audio, 0.8 alone). |