Nodes/IAMCCS-nodes/AU+IMG2VID Planner (legacy alias)
ComfyUI Node

AU+IMG2VID Planner (legacy alias)

The head of the AU+IMG2VID chain that decides how many segments your video needs

By IAMCCS·Created 12 months ago·Updated 5 days ago· 117
AU+IMG2VID Planner (legacy alias)
  • audio
  • upstream_contract
  • linx
  • planner_payload
  • contract
  • linx
  • segment_count
  • continuation_loops
  • current_segment_start_frames
  • current_segment_unique_frames
  • current_source_end
  • report
  • total_frames
  • unique_segment_frames
  • first_segment_raw_frames
  • continuation_raw_frames
  • fps_out
◄goal1_presetcustom►
◄fps24.00►
◄segment_seconds10.00►
◄target_duration_seconds30.00►
◄duration_sourcetarget_duration_seconds►
◄planning_modeauto_profile►
◄content_profilevideoclip►
◄overlap_frames9►
◄ltx_round_modeup►
◄segment_index0►
◄surface_profilecompact►
◄backend_bindingltx_audio_guided_lowram►

If you've seen the LTX-2 audio + image-to-video SuperNode workflows the IAMCCS author publishes, this is the node at the very top of them. IAMCCS_AUIMG2VID_Planner is a legacy alias - in the source it's literally the same class as IAMCCS_Ltx2HelperModules_Planner, just registered under the old name so earlier AU+IMG2VID workflows keep loading without JSON edits. It's the planning brain: given a target duration (or an audio track), it works out how many segments your long video needs, how many frames each gets, and what to carry over.

The long-video problem it solves is the one every LTX-2 user hits: the model generates in fixed-context chunks (roughly 8n+1 frames), so a 30-second clip at 24fps is not one generation but several, stitched with overlapping context. Doing that by hand means redoing the frame math every time you change the duration. This node makes it a setting.

What you actually set:

  • goal1_preset - the fast path. lowram_safe_videoclip, lowram_fast_videoclip, normal_quality_videoclip, and lowram_monologue each bake in a segment length, planning mode, overlap, and backend binding (the _lowram ones push frame-saving settings). custom lets you set everything yourself.
  • duration_source - target_duration_seconds, audio (measure the connected AUDIO and plan to it), or max_audio_target. If your video is meant to match a voice track, audio is what you want.
  • segment_seconds, target_duration_seconds, fps, overlap_frames - the raw knobs when you're on custom.
  • content_profile - videoclip vs monologue changes how segments are sized; monologue keeps pacing sensible for speech.
  • backend_binding - ltx_audio_guided_lowram (default) / ltx_audio_guided_normal / custom. This is the contract the rest of the chain uses to pick behavior.

The important outputs are the planner_payload string - a JSON blob that every downstream helper module (AudioTimeline, KeyframeTimeline, RefreshPolicy, RuntimeBridge) consumes - plus segment_count, total_frames, unique_segment_frames, current_segment_start_frames, and fps_out. The contract and linx outputs are the pack's supernode connectors that carry context between nodes; beginners can mostly ignore them and just wire the payload.

Installing: it ships in IAMCCS/IAMCCS-nodes. ComfyUI Manager → search "IAMCCS", or cd ComfyUI/custom_nodes && git clone https://github.com/IAMCCS/IAMCCS-nodes.git, restart. No models to download, no extra pip deps; the pack wants a recent ComfyUI (≥ 0.3.0), Python 3.12+ and Torch 2.8+.

Honest take: this node is only worth it if you're building the author's full AU+IMG2VID pipeline - it shines as the head of that chain, where the payloads it produces keep six other nodes in sync. Grabbed standalone, it's a segment calculator with extra steps. And note the naming is a trap for the unwary: you'll also see the same node in the menu as IAMCCS_Ltx2HelperModules_Planner - same thing, pick either. Where people get burned is trusting the preset blindly; the _lowram presets assume a specific backend binding, so if you switch backend_binding to normal keep the other settings consistent or you'll get a plan that fights your sampler chain. The community treats IAMCCS's video tooling as legit - its SVI Pro v2 work got a 200+ upvote r/comfyui thank-you - but the plan is only as good as the workflow around it.

CategoryIAMCCS/Ltx2 Helper Modules

Inputs (15)

NameTypeDefaultDescription
goal1_presetCOMBOcustom5 options: custom, lowram_safe_videoclip, lowram_fast_videoclip, normal_quality_videoclip, lowram_monologue
fpsFLOAT24.000.001–240—
segment_secondsFLOAT10.000.01–3600—
target_duration_secondsFLOAT30.000.01–36000—
duration_sourceCOMBOtarget_duration_seconds3 options: target_duration_seconds, audio, max_audio_target
planning_modeCOMBOauto_profile2 options: manual_segment_seconds, auto_profile
content_profileCOMBOvideoclip2 options: videoclip, monologue
overlap_framesINT90–4096—
ltx_round_modeCOMBOup3 options: up, nearest, down
segment_indexINT00–100000—
surface_profileCOMBOcompact3 options: compact, progressive, debug_surface
backend_bindingCOMBOltx_audio_guided_lowram3 options: ltx_audio_guided_lowram, ltx_audio_guided_normal, custom
audiooptAUDIO—
upstream_contractoptIAMCCS_SUPERNODE_CONTRACT—
linxoptIAMCCS_SUPERNODE_LINX—

Outputs (14)

NameTypeDescription
planner_payloadSTRING—
contractIAMCCS_SUPERNODE_CONTRACT—
linxIAMCCS_SUPERNODE_LINX—
segment_countINT—
continuation_loopsINT—
current_segment_start_framesINT—
current_segment_unique_framesINT—
current_source_endINT—
reportSTRING—
total_framesINT—
unique_segment_framesINT—
first_segment_raw_framesINT—
continuation_raw_framesINT—
fps_outFLOAT—