/add-music

name: add-music
description: Generate background music and add it to your Remotion project. Describe the mood/genre you want, and this will generate a track via Suno and wire it into your composition with proper fade in/out.

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.