/music-to-storyboard — Music → Storyboard

Usage

/music-to-storyboard <audio_file_or_analysis_json>

Steps

1. Validate input (audio file or JSON)
2. Generate storyboard:

python3 -m music_analyzer storyboard "<input_path>"

1. 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
2. Suggest using

   /storyboard-generator

   from pull-film to create the visual storyboard

Section → Shot Mapping

Output Format

{
  "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
    }
  ]
}