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, and the official ElevenLabs music skill (npx skills add elevenlabs/skills) for the API details.

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

Generate with Eleven Music (music_v2_5). It's cleared for commercial use on paid ElevenLabs plans, and the Music API needs one.

1. If ELEVENLABS_API_KEY isn't set for the project, run npx -y @elevenlabs/cli@latest onboard init from the project root and follow what it prints. Never ask for the key in chat.
2. npm i @elevenlabs/elevenlabs-js, then add a music entry to scripts/generate-audio.ts (create it from the audio-integration rule if it doesn't exist):

const music = [
  { name: "music-bg", prompt: "[genre] background music, [mood], [tempo], [additional descriptors]", lengthMs: 30_000 },
];

1. Set lengthMs to the video length plus a few seconds (measure the voiceover first if there is one). The script forces instrumental output; for a track with vocals, set forceInstrumental: false.
2. Run node scripts/generate-audio.ts from the project root. The track lands at public/music-bg.mp3. To regenerate it, delete the file and run the script again.

Good prompt examples:

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