Add Music Bed

music_bed

Lay music under a video: looped or trimmed to length, faded, leveled, and mixed with any existing audio. Video is stream-copied.

audiowritesdestructivesince v0.7.0

00:00PARAMETERS

Name	Type	Description
`video` required	`string`	Path to the video.
`music` required	`string`	Music audio file.
`musicVolume`	`number`	0..1 (default 0.25 over existing audio, 0.8 alone). ≥ 0
`fadeIn`	`number`	Fade-in seconds (default 1). ≥ 0
`fadeOut`	`number`	Fade-out seconds (default 2). ≥ 0
`duck`	`boolean`	Duck the music under the original audio (default false).
`output`	`string`	Optional output path. Defaults under SCREENCAST_HOME/edits.
`overwrite`	`boolean`	Allow replacing an existing file at the output path (default false).

00:05A MINIMAL CALL

music_bed { "video": "recording.mp4", "music": "music.mp3" }

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary:

Field	Type	Description
`outputPath` always	`string`	Path of the file written.

00:15SEEN IN