/add-music

Add Music — Generate & Integrate Background Music

You are helping the user add background music to their Remotion project.

Load the remotion-production skill for the music-scoring and audio-integration rules.

Workflow

1. Understand the Mood

If not already described, ask the user:

• Genre — Electronic, jazz, classical, lo-fi, ambient, rock, orchestral, pop?
• Mood — Upbeat, calm, dramatic, inspiring, playful, cinematic?
• Tempo — Fast, medium, slow?
• Vocals — Instrumental only (recommended for background), or with vocals?

2. Generate Music

Craft a descriptive prompt and generate:

Use remotion-media generate_music:
- prompt: "[genre] background music, [mood], [tempo], no vocals, [additional descriptors]"
- project_path: [project root path]

Good prompt examples:

• "upbeat electronic background music, energetic, no vocals, modern tech startup vibe"
• "calm acoustic guitar, warm and friendly, no vocals, coffee shop atmosphere"
• "epic cinematic orchestral, building tension and release, no vocals, trailer style"
• "chill lo-fi hip hop beats, relaxed and dreamy, no vocals, study music vibe"

3. Wire into Composition

Add with fade in/out:

import { Audio, interpolate, staticFile, useCurrentFrame, useVideoConfig } from "remotion";

const frame = useCurrentFrame();
const { durationInFrames, fps } = useVideoConfig();

const musicVolume = interpolate(
  frame,
  [0, fps, durationInFrames - 2 * fps, durationInFrames],
  [0, 0.25, 0.25, 0],
  { extrapolateLeft: "clamp", extrapolateRight: "clamp" }
);

<Audio src={staticFile("[returned-file-path]")} volume={musicVolume} />

4. Adjust for Voiceover (if present)

If the project has a voiceover, implement volume ducking — lower music to 0.1 during narration, 0.3 during silent parts. See audio-integration rule for the pattern.

5. Preview

Tell the user to check the audio in the Remotion preview (npm run dev).

Offer adjustments:

• Volume too loud/quiet?
• Wrong mood? Regenerate with a different prompt.
• Music too short? Use <Loop> to repeat it.
• Need different music for different sections? Generate multiple tracks.