/music-to-storyboard — Music → Storyboard

Generate a shot-by-shot storyboard from music analysis, with shot types, camera movements, visual descriptions, mood, and transitions. Output is compatible with pull-film's storyboard-generator format.

Usage

/music-to-storyboard <audio_file_or_analysis_json>

Accepts either an audio file (runs analysis first) or a previously saved analysis JSON.

Steps

• Validate input (audio file or JSON)

• Generate storyboard:

python3 -m music_analyzer storyboard "<input_path>"

Present storyboard as a table or sequence:

• Shot # with section label and time range

• Shot type: wide, medium, close-up, etc.

• Camera movement: static, dolly, orbit, etc.

• Visual description (Chinese + English)

• Transition to next shot: cut, dissolve, fade

• Energy level and mood

Suggest using /storyboard-generator from pull-film to create the visual storyboard

Section → Shot Mapping

Section Default Shot Camera Visual Treatment

Intro Wide → Medium Slow dolly in Environment establishing

Verse Medium, Close-up Static, slow pan Narrative focus

Chorus Wide, Close-up Orbit, fast push Visual climax

Bridge Close-up, Wide Slow dolly out Contrast, reflection

Outro Wide Slow pull-out Closure, fade

Output Format

Compatible with pull-film's storyboard-generator:

{ "song_title": "example.mp3", "total_duration": 240.5, "bpm": 128.0, "shots": [ { "shot_number": 1, "section": "intro", "time_range": {"start": 0, "end": 15.5}, "shot_type": "wide", "camera_movement": "slow dolly in", "visual_description_zh": "...", "visual_description_en": "...", "transition": "fade", "energy_level": 0.3 } ] }