- Home
- Skills
- Image & Video
- timeline-bgm
Timeline Bgm
Generate precision-timed, royalty-free background music for videos using local Python synthesis and timeline JSONs.
Free
Works with the AI Agents you already use
timeline-bgm
Example session with this skill installed
I have a 30s video. Use the 'intro' style for 0-5s, 'build' for 5-10s, and 'drop' for 10-30s. Set the downbeat at 10s, BPM 124, key G minor. Generate the BGM.
- Read your context and instructions
- Compiled the timeline-bgm
I have created a timeline with your specific scene transitions and musical parameters. I aligned the bar grid so the downbeat lands exactly at the 10-second mark to match your drop.
BGM Generation Report
| Parameter | Value |
|---|---|
| Duration | 30.0 Seconds |
| BPM / Key | 124 / G minor |
| Downbeat | 10.0s (Bar grid aligned) |
| Seed | 42 (Auto-generated) |
| Normalization | -16 LUFS |
Timeline Configuration
{
"bpm": 124,
"key": "Gm",
"downbeat": 10.0,
"scenes": [
{ "start": 0, "end": 5, "style": "intro" },
{ "start": 5, "end": 10, "style": "build" },
{ "start": 10, "end": 30, "style": "drop" }
]
}
Synthesis Command
python3 scripts/generate_bgm.py timeline.json -o output_bgm.wav --bpm 124 --key "Gm" --downbeat 10 --seed 42 --lufs -16
Next steps
- Listen to
output_bgm.wavto verify the intensity shift at 10 seconds. - Use
scripts/mix_video.sh your_video.mp4 output_bgm.wav final_render.mp4to combine them. - Adjust the
--seedvalue and re-run if you want a different melodic variation.
Connects securely to your tools. The creator never sees your data.
About this skill
Royalty-free background music that follows your edit — generated locally, not fetched from a library.
timeline-bgm composes an original BGM track from a simple timeline.json: a list of scenes (intro / build / drop / outro) and the moments that matter — a number landing, a title card, a transition. The music stays quiet under the intro, rises through the build, and the drop lands exactly on your key moment, with the bar grid aligned to it and a one-beat breath right before it, so the hit feels intentional.
Why not a stock track or a music API?
- No licensing risk — every note is synthesized locally by the bundled Python scripts. Use the output anywhere, including commercial and monetized videos.
- No API keys, no per-call fees, no uploads — it runs 100% offline on your machine.
- Reproducible — same timeline + same seed = the same track, so re-renders never change the music under an approved edit.
Three ways to get a timeline:
- Hand-write timeline.json from the included template (the full format spec is in the package).
- Convert a Markdown storyboard table (time / timecode columns) with one command.
- Extract a timeline from a Remotion project or a single HTML file (best effort — review before generating).
Then generate bgm.wav (loudness-normalized to -16 LUFS by default) and, if you want, mix it straight into your video — ducked under the original audio — with the included shell script.
Built for Remotion, HTML/Canvas, and Python render pipelines: anything that can describe scenes in seconds.
Requirements: Python 3.10+, pip install numpy soundfile, ffmpeg on PATH.
Requires Python 3.10+, numpy, soundfile, and ffmpeg. Heuristic extraction from HTML/Remotion may require manual time correction.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 3 days ago
- Free with an Agensi account
Requires