Nodes/IAMCCS-nodes/V2V Shotboard Easy - Wan Animate 2 Edition
ComfyUI Node

V2V Shotboard Easy - Wan Animate 2 Edition

A full-screen control shell for Wan-Animate-2 long-form video, without the spaghetti graph

By IAMCCS·Created 11 months ago·Updated 4 days ago· 113
V2V Shotboard Easy - Wan Animate 2 Edition
    • cine_linx
    • report
    source_video_path
    source_image_path
    duration_seconds2.70
    fps30.00
    trim_start_s0.00
    trim_end_s2.70
    frame_load_cap81
    generation_width832
    generation_height480
    chunk_frames81
    generation_steps6
    generation_cfg1.00
    generation_seed0
    seed_modefixed
    reference_image_strength1.00
    pose_strength1.00
    pose_start_percent0.00
    pose_end_percent1.00
    enable_context_windowstrue
    context_length_latents21
    context_overlap_latents8
    context_schedulestandard_static
    context_fuse_methodpyramid
    enable_pose_cachetrue
    cache_devicecpu
    cache_dtypeint8
    reference_background_modekeep_reference_background
    output_background_modenative_generated
    live_chunk_previewmiddle_frame
    empty_cache_each_chunkfalse
    model_nameauto / graph
    lora_nameauto / graph
    apply_distill_lorafalse
    lora_strength1.00
    clip_nameauto / graph
    clip_vision_nameauto / graph
    vae_nameauto / graph
    global_promptCharacter appearance: preserve the reference identity, clothing, proportions and detail. Background: preserve a stable coherent environment.
    pose_promptFollow the driving video motion, facial expression, gaze and body performance precisely.
    negative_promptidentity drift, duplicated person, malformed anatomy, flicker, static motion, subtitles, text, low quality
    output_prefixIAMCCS/WAN_ANIMATE_2_EASY
    timeline_data
    preview_stagesource

    A native Wan-Animate-2 workflow is a big graph: loader, conditioning, context windows, chunking, pose cache, compositing, and every knob is a separate widget scattered across the canvas. IAMCCS_V2VShotboardEasyWanAnimate2 is the opposite approach - one full-screen control panel with every setting you'd actually touch, mapped to the backend graph underneath. You get the full Wan-Animate-2 motion-transfer pipeline behind a single node that hands a cine_linx plan to a companion backend.

    What it controls

    The panel mirrors the real Wan-Animate-2 knobs one-for-one. Source side: source_video_path, source_image_path, duration_seconds, fps, trim_start_s/trim_end_s, and frame_load_cap. Generation side: generation_width/height (832×480 default), chunk_frames (81 - the official Wan-Animate-2 default, enforced to 4n+1), generation_steps/cfg/seed with seed_mode fixed-or-increment, reference_image_strength, and the pose block (pose_strength, pose_start_percent, pose_end_percent).

    Then the long-form machinery that makes this worth using over the raw nodes:

    • enable_context_windows with context_length_latents (21), context_overlap_latents (8), context_schedule and context_fuse_method - the chunk-to-chunk continuity system.
    • enable_pose_cache with cache_device (cpu/gpu) and cache_dtype (int8/int4/default) - so you don't re-encode pose embeddings for every chunk.
    • reference_background_mode (keep_reference_background vs isolate_character, which needs reference_character_mask).
    • output_background_mode - native_generated, or composite over source_video, reference_image, or a custom_background plate.
    • live_chunk_preview, empty_cache_each_chunk.

    Plus the text stack (global_prompt, pose_prompt, negative_prompt), model/LoRA/CLIP/VAE name slots (default "auto / graph" - the backend decides), and timeline_data for shotboard-style planning.

    How it wires up

    The single output is cine_linx plus a report. That contract is consumed by IAMCCS_WanAnimate2ShotboardBridge, which unpacks the plan into typed values (trim_start_s, target_frames, chunk_frames, generation_steps, pose_strength, the context settings, prompts, and an effective_lora_strength that is only nonzero when apply_distill_lora is on). Those values drive the actual IAMCCS_WanAnimate2Extends sampling node. So the Easy shell is a planner: it does the duration/trim/chunk arithmetic (chunk_count from ceil((frame_cap-1)/(chunk-1))), packages your decisions, and the backend executes them. It never loads the model itself.

    The honest take

    This is a quality-of-life node for people who run Wan-Animate-2 long-form a lot. If you already have a tuned native graph and know it, the Easy shell is a convenience, not a capability bump - you can reproduce every one of these settings in the raw nodes. What it genuinely buys you: one surface to edit, prompts that travel with the plan, chunk/trim arithmetic that can't go stale, and a cine_linx contract that makes the workflow printable and versionable. Where people stumble: leaving chunk_frames off a 4n+1 boundary (the panel clamps it, the raw graph doesn't), and forgetting the shell is a planner - the model must come from the backend graph you wire it into.

    Install the pack via ComfyUI Manager (search "IAMCCS") or cd ComfyUI/custom_nodes && git clone https://github.com/IAMCCS/IAMCCS-nodes.git, restart.

    CategoryIAMCCS/V2V/Easy

    Inputs (43)

    NameTypeDefaultDescription
    source_video_pathSTRING
    source_image_pathSTRING
    duration_secondsFLOAT2.700.01–3600
    fpsFLOAT30.001–120
    trim_start_sFLOAT0.000–3600
    trim_end_sFLOAT2.700.01–3600
    frame_load_capINT811–100000
    generation_widthINT83216–4096
    generation_heightINT48016–4096
    chunk_framesINT815–1025
    generation_stepsINT61–100
    generation_cfgFLOAT1.000–30
    generation_seedINT00–18446744073709550000
    seed_modeCOMBOfixed2 options: fixed, increment
    reference_image_strengthFLOAT1.000–10
    pose_strengthFLOAT1.000–10
    pose_start_percentFLOAT0.000–1
    pose_end_percentFLOAT1.000–1
    enable_context_windowsBOOLEANtrue
    context_length_latentsINT211–1024
    context_overlap_latentsINT80–1023
    context_scheduleCOMBOstandard_static4 options: standard_static, standard_uniform, looped_uniform, batched
    context_fuse_methodCOMBOpyramid4 options: pyramid, relative, flat, overlap-linear
    enable_pose_cacheBOOLEANtrue
    cache_deviceCOMBOcpu2 options: cpu, gpu
    cache_dtypeCOMBOint83 options: int8, int4, default
    reference_background_modeCOMBOkeep_reference_background2 options: keep_reference_background, isolate_character
    output_background_modeCOMBOnative_generated4 options: native_generated, source_video_composite, reference_image_composite, custom_background_composite
    live_chunk_previewCOMBOmiddle_frame4 options: off, first_frame, middle_frame, last_frame
    empty_cache_each_chunkBOOLEANfalse
    model_nameSTRINGauto / graph
    lora_nameSTRINGauto / graph
    apply_distill_loraBOOLEANfalse
    lora_strengthFLOAT1.00-10–10
    clip_nameSTRINGauto / graph
    clip_vision_nameSTRINGauto / graph
    vae_nameSTRINGauto / graph
    global_promptSTRINGCharacter appearance: preserve the reference identity, clothing, proportions and detail. Background: preserve a stable coherent environment.
    pose_promptSTRINGFollow the driving video motion, facial expression, gaze and body performance precisely.
    negative_promptSTRINGidentity drift, duplicated person, malformed anatomy, flicker, static motion, subtitles, text, low quality
    output_prefixSTRINGIAMCCS/WAN_ANIMATE_2_EASY
    timeline_dataSTRING
    preview_stageCOMBOsource6 options: source, reference, pose, mask, intermediate, output

    Outputs (2)

    NameTypeDescription
    cine_linxIAMCCS_SUPERNODE_LINX
    reportSTRING