IAMCCS Cine Videoclip Maker Planner
Planning a music video shot by shot, beat by beat, from one node
- audio
- music_linx
- image_prompt
- video_global_prompt
- video_local_prompts
- segment_lengths
- negative_prompt
- frame_count_true
- frame_count_adjusted
- start_seconds
- duration_seconds
- total_shots
- report
Making a music video with local AI is a two-model job: an image model for the stills, then a video model to animate them. IAMCCS Cine Music Video Planner is the node that plans that pipeline for you, shot by shot. For each shot in the sequence it produces the image prompt (with your style modifier), the video prompt for animating that still, the beat segmentation, and the exact frame counts - so a Z-Image Turbo still can become an LTX-2.3 audio-i2v shot that lands on the beat.
The display name says "Videoclip Maker Planner," which is accurate: it's the planning layer, not the generation. You still wire up the image generator and the video backend; this node just makes sure every shot is sized, prompted, and timed consistently. It's the most "music-sequencer-inspired" node in the pack, and it shows.
How it works
You have three ways to size a shot:
manual_shot_seconds(default 4) withmanual_total_shots(default 8) - flat, even shots.audio_divided_by_total_shots- split the connectedaudioevenly across shots.max_manual_audio_slice- the longer of manual or audio-divided.
Or skip all that and feed sequence_json from an external music-video sequencer (it reads shots/sequence/segments/timeline arrays, with per-shot duration, prompt, action, frame counts). The planner then assembles each shot from two banks: image_prompt_bank (stills: "lead singer in a moody neon rehearsal room…") and video_action_bank (motion: "the performer breathes with the beat…"), cycling through them per shot. image_style_modifier gets appended to every image prompt; beats_per_shot (default 4) splits each shot's frames into sub-beats for the video segment math. The image_model_hint (z_image_turbo, flux_9b, …) and video_backend_hint (ltx23_i2v_audio, ltx23_i2v, wan22_i2v, custom) are metadata that keep your downstream choices consistent.
The outputs that matter
image_prompt- the still prompt for this shot, ready for your image model.video_global_promptandvideo_local_prompts- for the video backend (and PromptRelay-style segment conditioning).segment_lengths- the beat/sub-beat frame counts.frame_count_truevsframe_count_adjusted- the raw frame count and the 8n+1-rounded one LTX actually wants. If these differ, feedframe_count_adjustedto the latent.start_seconds,duration_seconds,total_shots- timeline positioning.music_linx- the plan bus for the rest of the pipeline.negative_prompt- passthrough.
Install
In IAMCCS-nodes:
cd ComfyUI/custom_nodes
git clone https://github.com/IAMCCS/IAMCCS-nodes.git
or Manager → search IAMCCS. README floor: ComfyUI ≥ 0.3.0, Python ≥ 3.12, Torch ≥ 2.8. For the full intended stack you'll also want an image model (Z-Image Turbo is the hinted default), an LTX 2.3 audio-i2v setup, and - if you're making something that actually syncs to music - MelBand vocal conditioning per the pack's SuperNodes requirements doc.
Where people get burned
- It plans; it doesn't sync. The node sizes shots to the beat, but whether motion actually lands on the beat is up to the video model and your audio conditioning. Manage expectations: this gives you planned rhythm, not guaranteed sync.
- The prompt banks are the product. The default banks are good starting points, but the quality ceiling is your
image_prompt_bank/video_action_bank. Thin banks → repetitive shots; the node cycles them, so keep at least as many entries as you have shots. shot_indexis 0-based here (starts at 0), unlike the Multi-Gen Director (1-based). Inconsistent across the pack - double-check when looping.- Frame rounding. Watch
frame_count_adjustedvstrue. The adjusted value is what LTX accepts; feeding the true count into an LTX latent is a classic "why is my latent the wrong length" bug. - Zero search impressions, one-author tooling. It's a solid planner but it's opinionated about the whole stack - adopt the whole Cine/Videoclip pipeline or just steal its prompt-bank structure for your own workflow.
Inputs (16)
| Name | Type | Default | Description |
|---|---|---|---|
| shot_index | INT | 00–10000 | — |
| fps | FLOAT | 24.001–120 | — |
| manual_shot_seconds | FLOAT | 4.000.1–120 | — |
| manual_total_shots | INT | 81–512 | — |
| duration_mode | COMBO | manual_shot_seconds | 3 options: manual_shot_seconds, audio_divided_by_total_shots, max_manual_audio_slice |
| frame_rounding | COMBO | up_8n_plus_1 | 3 options: up_8n_plus_1, nearest_8n_plus_1, none |
| beats_per_shot | INT | 41–64 | — |
| image_model_hint | COMBO | z_image_turbo | 3 options: z_image_turbo, flux_9b, any_i2i_image_generator |
| video_backend_hint | COMBO | ltx23_i2v_audio | 4 options: ltx23_i2v_audio, ltx23_i2v, wan22_i2v, custom |
| sequence_json | STRING | — | |
| global_video_prompt | STRING | cinematic music video with rhythm-driven camera movement, coherent subject identity and continuous visual energy | — |
| image_style_modifier | STRING | photorealistic, cinematic music video still, real-world materials, physically accurate lighting, subtle film grain, high detail, no text, no watermark | — |
| image_prompt_bank | STRING | lead singer in a moody neon rehearsal room, cinematic portrait, expressive eyes wide shot of the band performing under colored stage lights, smoke haze, high energy close-up of hands on an electric guitar, strings vibrating, dramatic side light urban night exterior, performer walking through rain reflections, music video look abstract close-up of light beams and glass reflections moving with the beat final heroic performance frame, camera low angle, intense backlight | — |
| video_action_bank | STRING | the performer breathes with the beat, subtle head movement and eye contact, slow push-in the camera cuts to a wider energetic performance feeling, lights pulse with the rhythm hands strike instruments in sync with the beat, sharp close-up motion and quick details the performer walks forward through the environment, confident rhythm-driven movement abstract lights and reflections swell on the chorus, dynamic camera drift the shot builds to a final powerful performance moment, camera pushes forward | — |
| negative_prompt | STRING | text, watermark, logo, subtitles, low detail, plastic CGI, broken anatomy, bad hands, flicker, random objects, incoherent identity | — |
| audioopt | AUDIO | — |
Outputs (12)
| Name | Type | Description |
|---|---|---|
| music_linx | IAMCCS_SUPERNODE_LINX | — |
| image_prompt | STRING | — |
| video_global_prompt | STRING | — |
| video_local_prompts | STRING | — |
| segment_lengths | STRING | — |
| negative_prompt | STRING | — |
| frame_count_true | INT | — |
| frame_count_adjusted | INT | — |
| start_seconds | FLOAT | — |
| duration_seconds | FLOAT | — |
| total_shots | INT | — |
| report | STRING | — |