music-video

# music-video Generate a 60-second 9:16 vertical music video from a music file + mood keywords. Designed for YouTube Shorts / TikTok / Reels upload. ## What this produces Given: - A music file (mp3 / wav / m4a / aac) — typically 60–240 seconds of operator-supplied music (Suno-generated, YouTube Audio Library, Pixabay, etc.). Music itself is the *only* audio track in the output. - A short list of mood keywords (3–6 comma-separated phrases like `"rainy street, jazz cafe, vinyl, wet pavement"`). Produces: - A **1080 × 1920 (9:16 vertical)** mp4, exactly 60 seconds. - 8 B-roll clips fetched from Pexels (per-keyword), trimmed and ordered to match phrase boundaries detected via `aubiotrack`. - Drum-onset-aligned glitch micro-edits (`aubioonset`) on static- camera clips only. - Vintage lo-fi processing (film grain, vignetting, zoom-pulse) per v6 defaults; tunable via env vars. - Optional post-shader pass: `pond` (water-surface ripple), `breathing` (5-s scale wave), `halation` (warm bloom), or `combo` (phrase-aware pond + halation envelope). ## How to invoke User-facing invocation: `/music-video <music_file_path> "<comma_separated_keywords>"` Examples: ```text /music-video "assets/music/Rainy Bossa.mp3" "rainy street, jazz cafe, vinyl, wet pavement" /music-video ~/Downloads/track.wav "tokyo neon, vibraphone, late night, shibuya" ``` If the user invokes without a path or without keywords, ask them for the missing input rather than guessing. ## Step-by-s...