V2V Shotboard Easy - Wan Animate 2 Edition
A full-screen control shell for Wan-Animate-2 long-form video, without the spaghetti graph
- cine_linx
- report
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_windowswithcontext_length_latents(21),context_overlap_latents(8),context_scheduleandcontext_fuse_method- the chunk-to-chunk continuity system.enable_pose_cachewithcache_device(cpu/gpu) andcache_dtype(int8/int4/default) - so you don't re-encode pose embeddings for every chunk.reference_background_mode(keep_reference_backgroundvsisolate_character, which needsreference_character_mask).output_background_mode-native_generated, or composite oversource_video,reference_image, or acustom_backgroundplate.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.
Inputs (43)
| Name | Type | Default | Description |
|---|---|---|---|
| source_video_path | STRING | — | |
| source_image_path | STRING | — | |
| duration_seconds | FLOAT | 2.700.01–3600 | — |
| fps | FLOAT | 30.001–120 | — |
| trim_start_s | FLOAT | 0.000–3600 | — |
| trim_end_s | FLOAT | 2.700.01–3600 | — |
| frame_load_cap | INT | 811–100000 | — |
| generation_width | INT | 83216–4096 | — |
| generation_height | INT | 48016–4096 | — |
| chunk_frames | INT | 815–1025 | — |
| generation_steps | INT | 61–100 | — |
| generation_cfg | FLOAT | 1.000–30 | — |
| generation_seed | INT | 00–18446744073709550000 | — |
| seed_mode | COMBO | fixed | 2 options: fixed, increment |
| reference_image_strength | FLOAT | 1.000–10 | — |
| pose_strength | FLOAT | 1.000–10 | — |
| pose_start_percent | FLOAT | 0.000–1 | — |
| pose_end_percent | FLOAT | 1.000–1 | — |
| enable_context_windows | BOOLEAN | true | — |
| context_length_latents | INT | 211–1024 | — |
| context_overlap_latents | INT | 80–1023 | — |
| context_schedule | COMBO | standard_static | 4 options: standard_static, standard_uniform, looped_uniform, batched |
| context_fuse_method | COMBO | pyramid | 4 options: pyramid, relative, flat, overlap-linear |
| enable_pose_cache | BOOLEAN | true | — |
| cache_device | COMBO | cpu | 2 options: cpu, gpu |
| cache_dtype | COMBO | int8 | 3 options: int8, int4, default |
| reference_background_mode | COMBO | keep_reference_background | 2 options: keep_reference_background, isolate_character |
| output_background_mode | COMBO | native_generated | 4 options: native_generated, source_video_composite, reference_image_composite, custom_background_composite |
| live_chunk_preview | COMBO | middle_frame | 4 options: off, first_frame, middle_frame, last_frame |
| empty_cache_each_chunk | BOOLEAN | false | — |
| model_name | STRING | auto / graph | — |
| lora_name | STRING | auto / graph | — |
| apply_distill_lora | BOOLEAN | false | — |
| lora_strength | FLOAT | 1.00-10–10 | — |
| clip_name | STRING | auto / graph | — |
| clip_vision_name | STRING | auto / graph | — |
| vae_name | STRING | auto / graph | — |
| global_prompt | STRING | Character appearance: preserve the reference identity, clothing, proportions and detail. Background: preserve a stable coherent environment. | — |
| pose_prompt | STRING | Follow the driving video motion, facial expression, gaze and body performance precisely. | — |
| negative_prompt | STRING | identity drift, duplicated person, malformed anatomy, flicker, static motion, subtitles, text, low quality | — |
| output_prefix | STRING | IAMCCS/WAN_ANIMATE_2_EASY | — |
| timeline_data | STRING | — | |
| preview_stage | COMBO | source | 6 options: source, reference, pose, mask, intermediate, output |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| cine_linx | IAMCCS_SUPERNODE_LINX | — |
| report | STRING | — |